Share via


GRAPH_ID_FROM_NODE_ID (Transact-SQL)

Aplica-se a: SQL Server 2017 (14.x) e versões posteriores Banco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Retorna a ID do grafo interno para determinada ID de nó.

Sintaxe

GRAPH_ID_FROM_NODE_ID ( node_id )

Argumentos

node_id

A representação de caracteres (JSON) para um dos seguintes:

  • A pseudo-coluna $node_id de uma tabela de nós.
  • A pseudo-coluna $from_id de uma tabela de borda.
  • A coluna $to_id de uma tabela de borda.

Valor retornado

Retorna a ID do grafo interno, que é um bigint.

Comentários

  • Devido à sobrecarga de desempenho da análise e validação da representação de caracteres (JSON) fornecida dos nós, você só deve usar GRAPH_ID_FROM_NODE_ID quando necessário. Na maioria dos casos, MATCH deve ser suficiente para consultas em tabelas de grafo.
  • Para GRAPH_ID_FROM_NODE_ID retornar um valor, a representação de caracteres (JSON) fornecida deve ser válida e o schema.table nomeado dentro do JSON deve ser uma tabela de nós válida.
  • Se uma ID de grafo é retornada pela função, a única garantia é que ela corresponderá a um inteiro válido. Não são feitas verificações se a ID do grafo está presente na tabela de nós.
  • O tipo de dados e o comportamento das IDs de grafo são detalhes específicos da implementação e estão sujeitos a alterações. Por exemplo, você não deve assumir que as IDs de grafo em uma determinada tabela de nós são sequenciais.

Exemplos

O exemplo a seguir retorna a ID de grafo interno para os nós na tabela de nós Person.

SELECT GRAPH_ID_FROM_NODE_ID($node_id)
FROM Person;

Estes são os resultados:

...
1764
1806
19051
...

Confira também