GRAPH_ID_FROM_EDGE_ID (Transact-SQL)

Aplica-se a: SQL Server 2017 (14.x) e versões posteriores do Banco de Dados SQL do AzureBanco de Dados SQL do Azure Banco de Dados SQL banco de dados SQL do Banco de Dados SQL do Azurebanco de dados SQL no Microsoft Fabric

Em tabelas de grafos SQL, a GRAPH_ID_FROM_EDGE_ID função retorna o ID interno do grafo para um determinado ID de aresta.

Sintaxe

GRAPH_ID_FROM_EDGE_ID ( edge_id )

Argumentos

edge_id

A representação de caracteres (JSON) da pseudocoluna $edge_id em 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 das bordas, você só deve usar GRAPH_ID_FROM_EDGE_ID quando necessário. Na maioria dos casos, MATCH deve ser suficiente para consultas em tabelas de grafo.
  • Para GRAPH_ID_FROM_EDGE_ID retornar um valor, o caractere JSON fornecido deve ser válido e o nomeado schema.table dentro do JSON deve ser uma tabela de borda válida.
  • Se uma ID de grafo é retornada pela função, a única garantia é que ela corresponderá a um inteiro válido. Nenhuma verificação será feita se o ID do gráfico estiver presente na tabela de borda.
  • 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 gráfico em uma determinada tabela de borda são sequenciais.

As tabelas de grafos foram introduzidas no SQL Server 2017. A GRAPH_ID_FROM_EDGE_ID função não estará disponível em SQL Server de 2016 nem em Fabric Data Warehouse.

Exemplos

O exemplo a seguir retorna a ID do gráfico interno para as bordas da tabela de borda friendOf.

SELECT GRAPH_ID_FROM_EDGE_ID($edge_id)
FROM friendOf;

Estes são os resultados:

...
25073
98943
69725
68781
30354
...