Configurar o Azure Data Explorer em uma atividade de cópia
Esse artigo descreve como usar a atividade de cópia no pipeline de dados para copiar dados de e para o Azure Data Explorer.
Configuração com suporte
Para a configuração de cada guia em atividade de cópia, vá para as seções a seguir, respectivamente.
Geral
Para Configuração geral da guia, acesse Geral.
Origem
As propriedades a seguir têm suporte para Azure Data Explorer na guia Origem de uma atividade de cópia.
As seguintes propriedades são necessárias:
Tipo de armazenamento de dados: selecione Externo.
Conexão: selecione uma conexão Azure Data Explorer na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão do Azure Data Explorer selecionando Novo.
Banco de dados: selecione o banco de dados na lista suspensa.
Usar consulta: selecione Tabelas ou Consulta.
Tabela: selecione a tabela na lista suspensa ou selecione Editar para inseri-la manualmente para fazer a leitura dos dados.
Consulta: especifique a solicitação somente leitura fornecida em um formato KQL. Use a consulta KQL personalizada como referência.
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 expire. O valor padrão é 10 minutos (00:10:00). O valor máximo permitido é de 1 hora (01:00:00).
- Sem truncamento: indica se deve truncar o conjunto de resultados retornado. Por padrão, o resultado é truncado após 500.000 registros ou 64 megabytes (MB). O truncamento é altamente 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 tem suporte para o último.
Destino
As propriedades a seguir têm suporte para Azure Data Explorer na guia Destino de uma atividade de cópia.
As seguintes propriedades são necessárias:
- Tipo de armazenamento de dados: selecione Externo.
- Conexão: selecione uma conexão Azure Data Explorer na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão do Azure Data Explorer selecionando Novo.
- Banco de dados: selecione o banco de dados na lista suspensa.
- Tabela: selecione a tabela na lista suspensa ou selecione Editar para inseri-la manualmente para fazer a gravação dos 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 recipiente 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 marcas de ingestão. Para mais informações, acesse Ingestão de dados do Azure Data Explorer.
Mapeamento
Para Configuração da guia Mapeamento, acesseConfigurar seus mapeamentos na guia mapeamento.
Configurações
Para configuração da guia Configurações, acesse Definir 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.
Informações de origem
| Nome | Descrição | Valor | Obrigatório | Propriedade de script JSON |
|---|---|---|---|---|
| Tipo de armazenamento de dados | Seu tipo de armazenamento de dados. | Externo | Yes | / |
| Conexão | Sua conexão com o armazenamento de dados de origem. | < sua conexão do Azure Data Explorer> | Sim | connection |
| Backup de banco de dados | Seu banco de dados que você usa como origem. | <o banco de dados> | Sim | Banco de Dados |
| Usar a consulta | A maneira de ler dados. Aplique Tabela para fazer a leitura dos dados da tabela especificada ou aplicar Consulta para fazer a leitura dos dados usando consultas. | • Tabela • Consulta |
Não | tabela Consulta |
| Tempo-limite da consulta | Especifique o tempo de espera antes que a solicitação de consulta expire. 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 megabytes (MB). O truncamento é altamente recomendado para um comportamento adequado da atividade. | selecionar ou desmarcar | Não | noTruncation: true ou false |
| Colunas adicionais | Adicione colunas de dados adicionais ao caminho relativo ou ao valor estático dos arquivos de origem do repositório. A expressão tem suporte para o último. | • Nome • Valor |
Não | additionalColumns: • nome • valor |
Informações de destino
| Nome | Descrição | Valor | Obrigatório | Propriedade de script JSON |
|---|---|---|---|---|
| Tipo de armazenamento de dados | Seu tipo de armazenamento de dados. | Externo | Yes | / |
| Conexão | Sua conexão com o armazenamento de dados de destino. | < sua conexão do Azure Data Explorer> | Sim | connection |
| Backup de banco de dados | O banco de dados que você usa como destino. | <o banco de dados> | Sim | Banco de Dados |
| Tabela | Sua tabela de dados de destino para gravar dados. | <o nome da sua tabela> | Sim | table |
| 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. | <Nome do mapeamento de ingestão> | Não | ingestionMappingName |
| Propriedades adicionais | Um recipiente 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 marcas de ingestão. Saiba mais em Ingestão de dados do Azure Data Explorer. | • Nome • Tipo • Valor |
Não | additionalProperties |