Share via

GRAPH_ID_FROM_NODE_ID (Transact-SQL)

  • Article

S’applique à : SQL Server 2017 (14.x) et versions ultérieures Azure SQL DatabaseAzure SQL Managed Instance

Retourne l’ID de graphe interne d’un ID de nœud donné.

Syntaxe

GRAPH_ID_FROM_NODE_ID ( node_id )

Arguments

node_id

Représentation en caractères (JSON) de l’un des éléments ci-dessous :

  • Pseudo-colonne $node_id d’une table de nœud.
  • Pseudo-colonne $from_id d’une table d’arête.
  • Colonne $to_id d’une table d’arête.

Valeur retournée

Retourne l’ID de graphe interne, qui correspond à une valeur bigint.

Notes

  • En raison de la surcharge de performances liée à l’analyse et à la validation de la représentation en caractères fournie (JSON) des nœuds, vous devez utiliser GRAPH_ID_FROM_NODE_ID seulement lorsque cela est nécessaire. Dans la plupart des cas, MATCH doit être suffisant pour les requêtes sur les tables de graphe.
  • Pour que GRAPH_ID_FROM_NODE_ID retourne une valeur, la représentation en caractères fournie (JSON) doit être valide et l’élément schema.table nommé dans le fichier JSON doit être une table de nœud valide.
  • Si un ID de graphe est retourné par la fonction, il est garanti qu’il sera un entier valide. Aucune vérification n’est effectuée si l’ID de graphe est présent dans la table de nœud.
  • Le type de données et le comportement des ID de graphe sont des détails spécifiques de l’implémentation et sont soumis à modification. Par exemple, vous ne devez pas supposer que les ID de graphe dans une table de nœud donnée sont séquentiels.

Exemples

L’exemple suivant retourne l’ID de graphe interne des nœuds de la table de nœud Person.

SELECT GRAPH_ID_FROM_NODE_ID($node_id)
FROM Person;

Voici les résultats :

...
1764
1806
19051
...

Voir aussi