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

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

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
• Origem
• Destino
• Mapeamento
• Configurações

Geral

Consulte as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.

Fonte

Acesse a guia Origem para configurar a origem da atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.

As seguintes propriedades são obrigatórias:

• Tipo de armazenamento de dados: selecione Externo.

• Conexão: selecione uma conexão do Armazenamento de Tabelas do Azure na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão do Armazenamento de Tabelas do Azure selecionando Novo.

• Use 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:

  

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

  Se você selecionar Consulta:

  

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

  • Query: especifique a consulta personalizada de Armazenamento de Tabelas para ler dados. A consulta de origem é um mapa direto da opção $filter de consulta compatível com o Armazenamento de Tabelas do Azure. Saiba mais sobre a sintaxe deste artigo.

    Observação

    A operação de consulta de Tabela do Azure atinge o tempo limite em 30 segundos, conforme imposto pelo serviço Tabela do Azure. Saiba como otimizar a consulta no artigo Design para consulta.

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

• Ignorar tabela não encontrada: especifica se deve-se permitir que a exceção da tabela não exista. Ele não é selecionado 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 tem suporte para o último.

Destino

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

As seguintes propriedades são obrigatórias:

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

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

• Tipo de inserção: selecione o modo para inserir dados na Tabela do Azure. Os modos são Mesclar e Substituir. Essa propriedade controla se linhas existentes na tabela de saída com a partição correspondente e as chaves de linha terão seus valores substituídos ou mesclados. Essa configuração se aplica no nível de linha, não no nível de tabela. Nenhuma opção exclui linhas na tabela de saída que não existam na entrada. Para saber mais sobre como as configurações de mesclagem e substituição funcionam, consulte Inserir ou mesclar entidade e Inserir ou substituir entidade.

• Seleção do valor da chave de partição: selecione entre Especificar valor de partição ou Usar coluna de 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 de partição:

  • Valor de 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 especificado, "AzureTableDefaultPartitionKeyValue" será utilizado como a chave da partição.

• Seleção do valor da chave de linha: selecione entre o identificador exclusivo ou use a colunade 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 são usados como chaves de linha. Se não especificado, um GUID é usado 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 inteiro (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 é timespan.

• 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. Especificar um valor somente quando desejar limitar as conexões simultâneas

Mapeamento

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

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

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 Armazenamento de Tabelas do Azure >	Sim	connection
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	Sim	/
Tabela	O nome da tabela na instância do banco de dados do Armazenamento de Tabelas do Azure.	< seu nome de tabela >	Sim	tableName
Consulta	Especifica a consulta personalizada de armazenamento da tabelas para ler dados. A consulta de origem é um mapa direto da opção $filter de consulta compatível com o Armazenamento de Tabelas do Azure. Saiba mais sobre a sintaxe deste artigo.	< sua consulta >	Não	AzureTableSourceQuery
Ignorar tabela não encontrada	Indica se deve permitir que exceção da tabela não exista.	selecionado ou não selecionado (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 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 Armazenamento de Tabelas do Azure >	Sim	connection
Tabela	O nome da tabela na instância do banco de dados do Armazenamento de Tabelas do Azure.	< seu nome de tabela >	Sim	tableName
Tipo de inserção	O modo para inserir dados na Tabela do Azure. Essa propriedade controla se linhas existentes na tabela de saída com a partição correspondente e as chaves de linha terão seus valores substituídos ou mesclados.	• Merge • Replace	Não	azureTableInsertType: • merge • replace
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.	• Especificar valor de partição • Usar coluna de destino	Não	/
Valor de partição padrão	O valor da chave de partição padrão que pode ser utilizado pelo coletor	< seu valor de partição padrão >	Não	azureTableDefaultPartitionKeyValue
Coluna de chave da partição	O nome da coluna cujos valores são usados como chaves de partição. Se não especificado, "AzureTableDefaultPartitionKeyValue" será utilizado como a chave da partição.	< sua coluna de chave da partição >	Não	azureTablePartitionKeyName
Seleção de 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 exclusivo • Usar coluna de destino	Não	/
Coluna de chave de linha	O nome da coluna cujos valores são usados como chaves de linha. Se não especificado, um GUID é usado 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	No	writeBatchTimeout
Máximo de conexões simultâneas	O limite superior de conexões simultâneas estabelecidas com o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando desejar limitar as conexões simultâneas.	< seu máximo de conexões simultâneas >	Não	maxConcurrentConnections

Conteúdo relacionado

• Visão geral do conector do Armazenamento de Tabelas do Azure