Partilhar via


Configurar a base de dados KQL numa atividade de cópia

Este artigo descreve como usar uma atividade de cópia num pipeline para copiar dados de e para o Banco de Dados KQL.

Configuração suportada

Para configurar cada separador na atividade de cópia, vá respetivamente para as secções seguintes.

General

Para Configuração da guia Geral , vá para Geral.

Fonte

As propriedades a seguir são suportadas para o Banco de Dados KQL na guia Origem de uma atividade de cópia.

Captura de ecrã a mostrar o separador origem e a lista de propriedades.

As seguintes propriedades são necessárias:

  • Conexão: Selecione Banco de Dados KQL na lista de tipos de armazenamento de dados.

  • Banco de Dados KQL: Selecione um Banco de Dados KQL existente no espaço de trabalho.

  • Usar consulta: Selecione Tabela ou Consulta.

    • Tabela: Selecione uma tabela na lista suspensa ou selecione Editar para inseri-la manualmente para ler dados.

      Captura de ecrã mostrando a tabela.

    • Consulta: especifique a solicitação somente leitura fornecida em um formato KQL. Use a consulta KQL personalizada como referência.

      Captura de ecrã a mostrar a consulta.

Em Avançado, você pode especificar os seguintes campos:

  • Tempo limite da consulta: especifique o tempo de espera antes que a solicitação de consulta atinja o tempo limite. O valor padrão é 10 minutos (00:10:00). O valor máximo permitido é de 1 hora (01:00:00).

  • Sem truncamento: indica se o conjunto de resultados retornado deve ser truncado. Por padrão, o resultado é truncado após 500.000 registros ou 64 MB. Recomenda-se fortemente o truncamento para garantir um comportamento adequado da atividade.

  • Colunas adicionais: Adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão é suportada para a segunda opção. Para saber mais, vá para Adicionar colunas adicionais durante a cópia.

    Captura de ecrã a mostrar colunas adicionais.

Destino

As seguintes propriedades são suportadas para a base de dados KQL no separador Destino de uma atividade de cópia.

Captura de ecrã a mostrar o separador de destino.

As seguintes propriedades são necessárias:

  • Conexão: Selecione um banco de dados KQL na lista de tipos de armazenamento de dados.
  • Banco de Dados KQL: Selecione um Banco de Dados KQL existente no espaço de trabalho.
  • Tabela: selecione uma tabela na lista suspensa ou selecione Editar para inseri-la manualmente para gravar dados.

Em Avançado, você pode especificar os seguintes campos:

  • Nome do mapeamento de ingestão: o nome de um mapeamento que foi pré-criado e atribuído previamente a uma tabela de destino do Banco de Dados KQL.

  • Propriedades adicionais: um saco de propriedades que pode ser usado para especificar qualquer uma das propriedades de ingestão que ainda não estão sendo definidas pelo destino do Banco de Dados KQL. Especificamente, pode ser útil para especificar etiquetas de ingestão. Para saber mais, vá para Ingestão de dados do Azure Data Explorer.

    Captura de ecrã a mostrar propriedades adicionais.

Mapeamento

Para Configuração da guia Mapeamento , vá para Configurar seus mapeamentos na guia Mapeamento.

Configurações

Para configurar a aba Definições, vá para Configurar as suas outras definições na aba Definições.

Resumo da tabela

As tabelas a seguir contêm mais informações sobre uma atividade de cópia em um banco de dados KQL.

Fonte da informação

Nome Description Valor Obrigatório Propriedade de script JSON
Tipo de armazenamento de dados do espaço de trabalho Selecione Banco de Dados KQL na lista de tipos de armazenamento de dados. Base de dados KQL Yes /
Base de dados KQL Selecione um banco de dados KQL existente no espaço de trabalho. <a sua Base de Dados KQL> Yes /
Utilizar consulta Selecione Tabela ou Consulta. Tabela
Consulta
Não tabela
consulta
Tempo limite da consulta Especifique o tempo de espera antes que a solicitação de consulta atinja o tempo limite. O valor padrão é 10 minutos (00:10:00). O valor máximo permitido é de 1 hora (01:00:00). Intervalo de tempo Não tempo de espera da consulta
Sem corte Indica se o conjunto de resultados retornado deve ser truncado. Por padrão, o resultado é truncado após 500.000 registros ou 64 MB. Recomenda-se fortemente o truncamento para garantir um comportamento adequado da atividade. Selecionar ou desmarcar Não noTruncation: verdadeiro ou falso
Colunas adicionais Adicione colunas de dados adicionais ao caminho relativo ou ao valor estático dos arquivos de origem de armazenamento. A expressão é suportada para a segunda opção. Saiba mais em Adicionar colunas adicionais durante a cópia. • Nome
• Valor
Não colunas adicionais:
• nome
• valor

Informações sobre o destino

Nome Description Valor Obrigatório Propriedade de script JSON
Tipo de armazenamento de dados do espaço de trabalho Selecione Banco de Dados KQL na lista de tipos de armazenamento de dados. Base de dados KQL Yes /
Base de dados KQL Selecione um banco de dados KQL existente no espaço de trabalho. <a sua Base de Dados KQL> Yes /
Tabela Sua tabela de dados de destino para gravar dados. <o nome da sua tabela> Yes tabela
Nome do mapeamento de ingestão O nome de um mapeamento que foi pré-criado e atribuído à tabela de destino do Banco de Dados KQL com antecedência. <o seu nome de mapeamento de ingestão> Yes ingestionMappingName
Propriedades adicionais Um pacote de propriedades que pode ser usado para especificar qualquer uma das propriedades de ingestão que ainda não estão sendo definidas pelo destino do banco de dados KQL. Especificamente, pode ser útil para especificar etiquetas de ingestão. Saiba mais sobre a ingestão de dados do Azure Data Explorer. • Nome
• Tipo
• Valor
Yes additionalProperties