Configurar o Armazenamento de Tabela do Azure em uma atividade de cópia

  • Artigo

Este artigo descreve como usar a atividade de cópia no pipeline de dados para copiar dados de e para o Armazenamento de Tabela do Azure.

Configuração suportada

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

Geral

Consulte as orientações de configurações gerais para configurar a guia Configurações gerais.

Source

Vá para a guia Origem para configurar sua fonte de atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.

Screenshot showing source tab and the list of properties.

As três propriedades a seguir são necessárias:

  • Tipo de armazenamento de dados: Selecione Externo.

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

  • Usar consulta: especifique a maneira de ler dados. Selecione Tabela para ler dados da tabela especificada ou selecione Consulta para ler dados usando consultas.

    Se você selecionar Tabela:

    Screenshot showing Use query when selecting Table.

    • Tabela: especifique o nome da tabela na instância do banco de dados do Armazenamento de Tabela do Azure. Selecione a tabela na lista suspensa ou digite o nome manualmente selecionando Editar.

    Se você selecionar Consulta:

    Screenshot showing Use query when selecting Query.

    • Tabela: especifique o nome da tabela na instância do banco de dados do Armazenamento de Tabela do Azure. Selecione a tabela na lista suspensa ou digite o nome manualmente selecionando Editar.

    • Consulta: especifique a consulta de armazenamento de tabela personalizada para ler dados. A consulta de origem é um mapa direto da $filter opção de consulta suportada pelo Armazenamento de Tabela do Azure, saiba mais sobre a sintaxe deste artigo.

      Nota

      A operação de consulta Tabela do Azure expira em 30 segundos, conforme imposto pelo serviço de Tabela do Azure. Saiba como otimizar a consulta no artigo Design for querying .

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

  • Ignorar tabela não encontrada: especifica se a exceção da tabela não deve ser permitida. Ele é desmarcado por padrão.

  • 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

Vá para a guia Destino para configurar o destino da atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.

Screenshot showing destination tab and the list of properties.

As três propriedades a seguir são necessárias:

  • Tipo de armazenamento de dados: Selecione Externo.
  • Conexão: selecione uma conexão do Armazenamento de Tabela do Azure na lista de conexões. Se não houver conexão, crie uma nova conexão de Armazenamento de Tabela do Azure selecionando Novo.
  • Tabela: especifique o nome da tabela na instância do banco de dados do Armazenamento de Tabela do Azure. Selecione a tabela na lista suspensa ou digite o nome manualmente selecionando Editar.

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

  • Inserir tipo: selecione o modo para inserir dados na Tabela do Azure. Os modos são Mesclar e Substituir. Esta propriedade controla se as linhas existentes na tabela de saída com chaves de partição e linha correspondentes têm seus valores substituídos ou mesclados. Essa configuração se aplica ao nível da linha e não ao nível da tabela. Nenhuma das opções exclui linhas na tabela de saída que não existem na entrada. Para saber como funcionam as configurações de mesclagem e substituição, consulte Inserir ou mesclar entidade e Inserir ou substituir entidade.

  • Seleção do valor da chave de partição: Selecione a partir da coluna Especificar valor da partição ou Usar destino. O valor da chave de partição pode ser um valor fixo ou pode obter valor de uma coluna de destino.

    Se você selecionar Especificar valor da partição:

    • Valor da partição padrão: especifique o valor da chave de partição padrão que pode ser usado pelo destino.

    Se você selecionar Usar coluna de destino:

    • Coluna de chave de partição: Selecione o nome da coluna cujos valores de coluna são usados como a chave de partição. Se não for especificado, "AzureTableDefaultPartitionKeyValue" será usado como a chave de partição.

  • Seleção do valor da chave de linha: selecione na coluna Identificador exclusivo ou Usar destino. O valor da chave de linha pode ser um identificador exclusivo gerado automaticamente ou pode obter valor de uma coluna de destino.

    Se você selecionar Usar coluna de destino:

    • Coluna de chave de linha: Selecione o nome da coluna cujos valores de coluna são usados como a chave de linha. Se não for especificado, use um GUID para cada linha.

  • Tamanho do lote de gravação: insere dados na Tabela do Azure quando o tamanho do lote de gravação especificado é atingido. Os valores permitidos são inteiros (número de linhas). O valor padrão é 10.000.

  • Tempo limite do lote de gravação: insere dados na Tabela do Azure quando o tempo limite do lote de gravação especificado é atingido. O valor permitido é timepan.

  • Máximo de conexões simultâneas: o limite superior de conexões simultâneas estabelecido para o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando quiser limitar conexões simultâneas

Mapeamento

Para a configuração da guia Mapeamento, consulte 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

A tabela a seguir contém mais informações sobre a atividade de cópia no Armazenamento de Tabela do Azure.

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 de Armazenamento de Tabela do Azure > Sim ligação
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		 Sim /
Tabela O nome da tabela na instância de banco de dados do Armazenamento de Tabela do Azure. < o nome da sua tabela > Sim tableName
Consulta Especifique a consulta de armazenamento de tabela personalizada para ler dados. A consulta de origem é um mapa direto da $filter opção de consulta suportada pelo Armazenamento de Tabela do Azure, saiba mais sobre a sintaxe deste artigo. < a sua questão > Não azureTableSourceQuery
Ignorar tabela não encontrada Indica se a exceção da tabela deve ser permitida. selecionado ou desmarcado (padrão) Não azureTableSourceIgnoreTableNotFound:
true ou false (padrão)
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. • 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 de Armazenamento de Tabela do Azure > Sim ligação
Tabela O nome da tabela na instância de banco de dados do Armazenamento de Tabela do Azure. < o nome da sua tabela > Sim tableName
Inserir tipo O modo para inserir dados na Tabela do Azure. Esta propriedade controla se as linhas existentes na tabela de saída com chaves de partição e linha correspondentes têm seus valores substituídos ou mesclados. • Mesclar
• Substituir		 Não azureTableInsertType:
• fundir
• substituir
Seleção do valor da chave de partição O valor da chave de partição pode ser um valor fixo ou pode obter valor de uma coluna de destino. • Especifique o valor da partição
• Use a coluna de destino		 Não /
Valor de partição padrão O valor da chave de partição padrão que pode ser usado pelo destino < seu valor de partição padrão > Não azureTableDefaultPartitionKeyValue
Coluna de chave de partição O nome da coluna cujos valores são usados como chaves de partição. Se não for especificado, "AzureTableDefaultPartitionKeyValue" será usado como a chave de partição. < sua coluna de chave de partição > Não azureTablePartitionKeyName
Seleção do valor da chave de linha O valor da chave de linha pode ser um identificador exclusivo gerado automaticamente ou pode obter valor de uma coluna de destino. • Identificador único
• Use a coluna de destino		 Não /
Coluna de chave de linha O nome da coluna cujos valores de coluna são usados como a chave de linha. Se não for especificado, use um GUID para cada linha. < sua coluna de chave de linha > Não azureTableRowKeyName
Tamanho do lote de gravação Insere dados na Tabela do Azure quando o tamanho do lote de gravação é atingido. inteiro
(o padrão é 10.000)		 Não writeBatchSize
Tempo limite de gravação em lote Insere dados na Tabela do Azure quando o tempo limite do lote de gravação é atingido timespan Não writeBatchTimeout
Máximo de conexões simultâneas O limite superior de conexões simultâneas estabelecidas para o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando quiser limitar conexões simultâneas. < suas conexões simultâneas máximas > Não maxConcurrentConnections

Conteúdos relacionados