Partilhar via

NODE_ID_FROM_PARTS (Transact-SQL)

Aplica-se a: SQL Server 2017 (14.x) e versões posteriores Azure SQL DatabaseAzure SQL Managed InstanceSQL database em Microsoft Fabric

Retorna a representação de caracteres (JSON) da ID do nó para uma determinada ID de objeto e ID de gráfico.

Sintaxe

NODE_ID_FROM_PARTS ( object_id, graph_id )

Arguments

object_id

Um int que representa o ID do objeto para a tabela de nós.

graph_id

Um valor bigint para o ID do gráfico de um nó.

Valor de retorno

Retorna uma representação de caracteres (JSON) nvarchar(1000) do ID do nó. O valor de retorno pode ser NULL se qualquer um dos argumentos fornecidos for inválido.

Observações

  • A representação de caracteres (JSON) do ID do nó retornado por NODE_ID_FROM_PARTS é um detalhe específico da implementação e está sujeita a alterações.
  • NODE_ID_FROM_PARTS é a única maneira suportada de construir uma representação de caractere adequada do ID do nó.
  • NODE_ID_FROM_PARTS é útil para a inserção em massa de dados em uma tabela gráfica, quando os dados de origem têm uma chave natural ou substituta adequada com um tipo de dados inteiro.
  • O valor retornado de NODE_ID_FROM_PARTS pode ser usado para preencher a $node_id coluna em uma tabela de nós. Ele também pode ser usado para preencher as $from_id / $to_id colunas em uma tabela de borda.
  • Para NODE_ID_FROM_PARTS retornar uma representação de caractere válida (JSON) de um ID de nó, o object_id parâmetro deve corresponder a uma tabela de nós existente. O graph_id parâmetro pode ser qualquer inteiro válido, mas não precisa existir nessa tabela de nós. Se qualquer uma dessas verificações falhar, NODE_ID_FROM_PARTS retornará NULL.

Examples

O exemplo a seguir usa o Provedor de Conjunto de Linhas em Massa OPENROWSET para recuperar as ID colunas e name de um arquivo CSV armazenado em uma conta de Armazenamento do Azure. Em seguida, ele usa NODE_ID_FROM_PARTS para criar a representação de caractere apropriada de $node_id para eventual (em massa) inserir na Person tabela de nós. Esses dados transformados são então (em massa) inseridos na Person tabela de nós.

INSERT INTO Person($node_id, ID, [name])
SELECT NODE_ID_FROM_PARTS(OBJECT_ID('Person'), ID) as node_id, ID, [name]
FROM OPENROWSET (BULK 'person_0_0.csv',
    DATA_SOURCE = 'staging_data_source',
    FORMATFILE = 'format-files/person.xml',
    FORMATFILE_DATA_SOURCE = 'format_files_source',
    FIRSTROW = 2) AS staging_data;
;

Consulte também

  • Last updated on