Partilhar via


Configurar o banco de dados KQL em uma atividade de cópia

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

Configuração suportada

Para a configuração de cada guia em atividade de cópia, vá para as seções a seguir, respectivamente.

Geral

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

Source

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

Screenshot showing source tab and the list of properties.

As seguintes propriedades são necessárias:

  • Tipo de armazenamento de dados: Selecione Espaço de trabalho.

  • Tipo de armazenamento de dados do espaço de trabalho: 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.

      Screenshot showing table.

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

      Screenshot showing query.

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. O truncamento é fortemente recomendado para 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 este último. Para saber mais, vá para Adicionar colunas adicionais durante a cópia.

    Screenshot showing additional columns.

Destino

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

Screenshot showing destination tab.

As seguintes propriedades são necessárias:

  • Tipo de armazenamento de dados: Selecione Espaço de trabalho.
  • Tipo de armazenamento de dados do espaço de trabalho: 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.
  • 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 a uma tabela de destino do Banco de Dados KQL com antecedência.

  • 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.

    Screenshot showing additional properties.

Mapeamento

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

Definições

Para Configuração da guia Configurações, vá para Configurar suas outras configurações na guia Configuraçõ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 Descrição valor Obrigatório Propriedade de script JSON
Tipo de armazenamento de dados Seu tipo de armazenamento de dados. Área de trabalho Sim /
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 Sim /
Base de dados KQL Selecione um banco de dados KQL existente no espaço de trabalho. <a sua Base de Dados KQL> Sim /
Utilizar consulta Selecione Tabela ou Consulta. • Tabela
• Consulta
Não tabela
query
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). timespan Não queryTimeout
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. O truncamento é fortemente recomendado para um comportamento adequado da atividade. Selecionar ou desmarcar Não noTruncação: 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 este último. Saiba mais em Adicionar colunas adicionais durante a cópia. • Nome
• Valor
Não adicionaisColunas:
• nome
• valor

Informações sobre o destino

Nome Descrição valor Obrigatório Propriedade de script JSON
Tipo de armazenamento de dados Seu tipo de armazenamento de dados. Área de trabalho Sim /
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 Sim /
Base de dados KQL Selecione um banco de dados KQL existente no espaço de trabalho. <a sua Base de Dados KQL> Sim /
Tabela Sua tabela de dados de destino para gravar dados. <o nome da sua tabela> Sim 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> Sim 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
Sim additionalProperties