Partilhar via


Configurar o Azure Data Explorer 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 Azure Data Explorer.

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 têm suporte para o Azure Data Explorer 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 Externo.

  • Conexão: selecione uma conexão do Azure Data Explorer na lista de conexões. Se não houver conexão, crie uma nova conexão do Azure Data Explorer selecionando Novo.

  • Banco de dados: Selecione seu banco de dados na lista suspensa.

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

Destino

As propriedades a seguir têm suporte para o Azure Data Explorer 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 Externo.
  • Conexão: selecione uma conexão do Azure Data Explorer na lista de conexões. Se não houver conexão, crie uma nova conexão do Azure Data Explorer selecionando Novo.
  • Banco de dados: Selecione seu banco de dados na lista suspensa.
  • 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: especifique o nome de um mapeamento que foi pré-criado e atribuído a uma tabela de destino do Azure Data Explorer com antecedência.

  • 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 Azure Data Explorer. 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 Azure Data Explorer.

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. Externa Sim /
Ligação Sua conexão com o armazenamento de dados de origem. < sua conexão do Azure Data Explorer > Sim ligação
Base de dados Seu banco de dados que você usa como fonte. < A sua base de dados > Sim base de dados
Utilizar consulta A maneira de ler dados. Aplique Table para ler dados da tabela especificada ou aplique Query para ler dados usando consultas. • 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 máximo permitido é de 1 hora (01:00:00). timespan
(o padrão é 00:10:00 - 10 minutos)
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. • 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. Externa Sim /
Ligação Sua conexão com o armazenamento de dados de destino. < sua conexão do Azure Data Explorer > Sim ligação
Base de dados Seu banco de dados que você usa como destino. < A sua base de dados > Sim base de dados
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 Azure Data Explorer com antecedência. <o seu nome de mapeamento de ingestão> Não 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 Azure Data Explorer. 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
Não additionalProperties