Share via


OBJECT_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 de objeto de determinada ID de nó do grafo.

Sintaxe

OBJECT_ID_FROM_NODE_ID ( node_id )

Argumentos

node_id

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

  • 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 object_id da tabela de grafo correspondente à node_id fornecida. object_id é um int. Se um node_id inválido é fornecido, o retorno é NULL.

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 OBJECT_ID_FROM_NODE_ID quando necessário. Na maioria dos casos, MATCH deve ser suficiente para consultas em tabelas de grafo.
  • Para OBJECT_ID_FROM_NODE_ID retornar um valor, a representação de caracteres (JSON) fornecida da ID de nó deve ser válida e o schema.table nomeado dentro do JSON deve ser uma tabela de nós válida. A ID de grafo dentro da representação de caracteres (JSON) não precisa existir na tabela de nós. Pode ser qualquer inteiro válido.
  • OBJECT_ID_FROM_NODE_ID é a única maneira com suporte para analisar a representação de caracteres (JSON) de uma ID de nó.

Exemplos

O exemplo a seguir retorna object_id para todos os nós $from_id da tabela de bordas do grafo likes. No Exemplo de Banco de Dados de Grafo do SQL, usamos apenas os valores $node_id da tabela Person como os valores $from_id correspondentes em likes. Portanto, os valores retornados são constantes e iguais à object_id da tabela Person (1525580473 neste exemplo).

SELECT OBJECT_ID_FROM_NODE_ID($from_id)
FROM likes;

Estes são os resultados:

...
1525580473
1525580473
1525580473
...

Confira também