Tous les Types de Données

Property

Chaque property de node ou edge créé a un type de données. Tous les types de données pris en charge pour les properties sont :

^[1] La précision est le nombre total de chiffres dans le nombre, incluant à la fois les parties entière et fractionnaire (excl. le point décimal). L'échelle est le nombre de chiffres à droite du point décimal.

Données Renvoyées

Une fois que les données sont récupérées de la base de données et traitées, elles peuvent être renvoyées avec les types suivants :

Exemple de graph :

NODE

Renvoyer le node dont le nom est Alice :

find().nodes({name == 'Alice'}) as n
return n{*}

Structure de données du node:

{
	"id": "STU001",
	"uuid": 1,
	"schema": "student",
	"values": {
		"name": "Alice",
		"age": 25
	}
}

EDGE

Renvoyer l'edge dont le UUID est 53 :

find().edges({_uuid == 53}) as e
return e{*}

Structure de données de l'edge :

{
	"uuid": 53,
	"schema": "studyAt",
	"from": "STU001",
	"to": "UNI001",
	"from_uuid": 1,
	"to_uuid": 1001,
	"values": {
		"start": 2001,
		"end": 2005
	}
}

PATH

Renvoyer le path d'Alice à Oxford :

n({name == 'Alice'}).e().n({name == 'Oxford'}) as p
return p{*}

Structure de données du path :

{
	"length": 1,
	"nodes": [{
		"id": "STU001",
		"uuid": 1,
		"schema": "student",
		"values": {
			"name": "Alice",
			"age": 25
		}
	}, {
		"id": "UNI001",
		"uuid": 1001,
		"schema": "university",
		"values": {
			"name": "Oxford"
		}
	}],
	"edges": [{
		"uuid": 53,
		"schema": "studyAt",
		"from": "STU001",
		"to": "UNV001",
		"from_uuid": 1,
		"to_uuid": 1001,
		"values": {
			"start": 2001,
			"end": 2005
		}
	}]
}

GRAPH

Renvoyer le graph formé par le path d'Alice à Oxford :

n({name == 'Alice'}).e().n({name == 'Oxford'}) as p
return toGraph(collect(p))

Structure de données du graph :

{
	"nodes": [{
		"id": "STU001",
		"uuid": 1,
		"schema": "student",
		"values": {
			"name": "Alice",
			"age": 25
		}
	}, {
		"id": "UNI001",
		"uuid": 1001,
		"schema": "university",
		"values": {
			"name": "Oxford"
		}
	}],
	"edges": [{
		"uuid": 53,
		"schema": "studyAt",
		"from": "STU001",
		"to": "UNI001",
		"from_uuid": 1,
		"to_uuid": 1001,
		"values": {
			"start": 2001,
			"end": 2005
		}
	}]
}

TABLE

Renvoyer le tableau de toutes les properties ID et name des nodes :

find().nodes() as n
return table(n._id, n.name)

Résultat :

Structure de données du tableau :

{
  "name": "table(n._id, n.name)",
  "alias": "table(n._id, n.name)",
  "headers": [
    "n._id",
    "n.name"
  ],
  "rows": [
    [
      "STU001",
      "Alice"
    ],
    [
      "UNI001",
      "Oxford"
    ]
  ]
}

ATTR

Renvoyer combien d'années Alice a étudié à Oxford :

find().edges({_uuid == 53}) as e
return e.end - e.start

Structure de données de la valeur :

{
  "values": [
    4
  ]
}

Pour spécifier un format de retour valide dans la clause RETURN, veuillez vous référer au tableau fourni ici.

Null

Dans Ultipa Graph, null signifie l'absence d'une valeur pour une property ou le résultat d'une requête. Cela diffère de 0 ou d'une chaîne vide. Les valeurs nulles sont rencontrées dans les scénarios suivants :

• Lors de l'insertion de nouveaux nodes ou edges (insert(), insert().overwrite()), les properties qui ne sont pas spécifiées reçoivent des valeurs nulles.
• Lors de la création d'une nouvelle property, les nodes ou edges existants du schema correspondant reçoivent des valeurs nulles pour la nouvelle property créée.
• Lorsqu'une property demandée n'existe pas, des valeurs nulles sont renvoyées à la place.
• Lors de l'utilisation du préfixe OPTIONAL pour une requête (find(), khop(), n().e().n(), etc.), si la requête ne donne pas de résultats, des valeurs nulles sont renvoyées à la place de rien.

Lorsque null est impliqué dans une expression d'opération conditionnelle :

• Si le jugement est définitif, retourne vrai ou faux;
• sinon, retourne null.

Tout calcul numérique (+, -, *, /, %) impliquant null aura pour résultat null.

Toute opération d'agrégation (count(), sum(), max(), min(), avg(), stddev(), collect()) impliquant null ignorera les lignes avec des valeurs nulles.

Fonctions et opérateurs liés à null:

• coalesce()
• ifnull()
• IS NULL
• IS NOT NULL.