Configurar o MySQL em uma atividade de cópia

Este artigo descreve como usar a atividade de cópia num pipeline para copiar dados de e para MySQL.

Este conector suporta MySQL versão 5.5, 5.6, 5.7, 8.0, 8.1 e 8.2.

Configuração suportada

Para configurar cada separador na atividade de cópia, vá respetivamente para as secções seguintes.

General

Consulte as orientações gerais de configuração para configurar o separador Configurações Gerais.

Fonte

As propriedades a seguir são suportadas para o MySQL na guia Fonte de uma atividade de cópia.

As seguintes propriedades são necessárias:

  • Conexão: Selecione uma conexão MySQL na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão MySQL selecionando Novo.
  • Usar consulta: Selecionar a partir de Tabela ou Consulta.
    • Se você selecionar Tabela:

      • Tabela: Especifique o nome da tabela no banco de dados MySQL para ler dados. Selecione a tabela na lista suspensa.

        Captura de ecrã a mostrar Utilizar consulta - Tabela.

    • Se você selecionar Consulta:

      • Consulta: especifique a consulta SQL personalizada para ler dados. Por exemplo: SELECT * FROM MyTable.

        Captura de ecrã que mostra Utilizar consulta - Consulta.

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

  • 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 a segunda opção.

Destino (Pré-visualização)

As seguintes propriedades são suportadas para o MySQL na aba Destino de uma atividade de cópia.

As seguintes propriedades são necessárias:

  • Conexão: Selecione uma conexão MySQL na lista de conexões. Se não existir ligação, então cria uma nova ligação MySQL.

  • Tabela: Selecione o nome da tabela na base de dados MySQL.

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

  • Script de pré-cópia: Especificar uma consulta SQL para a atividade de cópia executar antes de escrever dados no MySQL em cada execução. Você pode usar essa propriedade para limpar os dados pré-carregados.

  • Tempo limite de gravação em lote: Especifique o tempo de espera para a conclusão da operação de inserção em lote antes de expirar. O valor permitido é intervalo de tempo. O valor predefinido é 00:00:30.

  • Tamanho do lote de escrita: Especifique o número de linhas a inserir na tabela MySQL por lote. O valor permitido é inteiro (número de linhas). Um novo lote será criado quando o lote atual atingir o tamanho do lote de escrita. O valor predefinido é 10000.

  • Máximo de conexões simultâneas: especifique 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. O valor permitido é inteiro.

Mapeamento

Para a configuração da guia Mapeamento, consulte Configurar os seus mapeamentos na guia de Mapeamento.

Configurações

Para configurar a aba Definições, vá para Configurar as suas outras definições na aba Definições.

Mapeamento de tipo de dados para MySQL

Ao copiar dados do MySQL, os mapeamentos a seguir são usados de tipos de dados MySQL para tipos de dados temporários usados pelo serviço internamente.

Tipo de dados MySQL Tipo de dados intermédio
BIGINT Int64
BIGINT NÃO ASSINADO UInt64
BIT(1) UInt64
BIT(M), M>1 UInt64
BLOB Matriz de bytes
BOOL Booleano
(Se TreatTinyAsBoolean=false, ele é mapeado como SByte. TreatTinyAsBoolean é verdadeiro por padrão)
CHAR Cordão
DATE DateTime
DATETIME DateTime
DECIMAL Decimal
DUPLO Double
Double Precision Double
ENUM Cordão
FLOAT Solteiro
INT Int32
INT NÃO ASSINADO Int64
INTEGER Int32
INTEIRO NÃO ASSINADO UInt32
JSON Cordão
VARBINARY LONGO Matriz de bytes
VARCHAR LONGO Cordão
LONGBLOB Matriz de bytes
TEXTO LONGO Cordão
MEDIUMBLOB Matriz de bytes
MEDIUMINT Int32
MEDIUMINT NÃO ASSINADO UInt32
TEXTO MÉDIO Cordão
NUMÉRICO Decimal
REAL Double
SET Cordão
SMALLINT Int16
SMALLINT NÃO ASSINADO UInt16
TEXTO Cordão
TIME TimeSpan
DATA E HORA DateTime
TINYBLOB Matriz de bytes
TINYINT SByte
TINYINT não assinado Int16
TINYTEXT Cordão
VARCHAR Cordão
YEAR Integer

Ao copiar dados para MySQL, são usados os seguintes mapeamentos dos tipos de dados intermédios usados internamente pelo serviço para os tipos de dados MySQL.

Tipo de dados intermédio Tipo de dados MySQL
booleano BOOL, BOOLEANO
Byte TINYINT
Int16 SMALLINT, ANO
UInt16 SMALLINT NÃO ASSINADO
Int32 MEDIUMINT, INT, INTEIRO
UInt32 INT SEM ASSINATURA, MÉDIA SEM ASSINATURA
Int64 BIGINT
UInt64 BIGINT NÃO ASSINADO
Decimal DECIMAL
Solteiro FLOAT
Double DUPLO
Cordão VARCHAR, CHAR, VARSTRING, TEXT, TINYTEXT, MEDIUMTEXT, LONGTEXT, ENUM, SET, JSON
Matriz de bytes BINÁRIO, VARBINÁRIO, BLOB, TINYBLOB, MEDIUMBLOB, LONGBLOB, BIT, GEOMETRIA
Date DATE
DateTime DATA-HORA, MARCADOR TEMPORAL
TimeSpan TIME
GUID GUID, UUID

Resumo da tabela

As tabelas a seguir contêm mais informações sobre a atividade de cópia no MySQL.

Fonte da informação

Nome Description Valor Obrigatório Propriedade de script JSON
Conexão A sua conexão com os repositórios de dados de origem. < a tua ligação MySQL > Yes ligação
Utilizar consulta A maneira de ler dados do MySQL. Aplique Table para ler dados da tabela especificada ou aplique Query para ler dados usando consultas SQL. Tabela
Consulta
Yes /
Tabela Nome da tabela no banco de dados MySQL. < nome da tabela > Não tableName
Consulta Utilize uma consulta SQL personalizada para ler dados. Por exemplo: SELECT * FROM MyTable. < Consultas SQL > Não consulta
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 a segunda opção. • Nome
• Valor
Não colunas adicionais:
• nome
• valor

Informação do destino (Pré-visualização)

Nome Description Valor Obrigatório Propriedade de script JSON
Conexão A sua conexão com o repositório de dados de destino. < a tua ligação MySQL > Yes ligação
Tabela Nome da tabela no banco de dados MySQL. < nome da tabela > Yes tableName
Script de pré-cópia Uma consulta SQL para a atividade de cópia a executar antes de escrever dados no MySQL em cada execução. Você pode usar essa propriedade para limpar os dados pré-carregados. < o seu script de pré-cópia > Não preCopyScript
Comportamento de escrita Define o comportamento de escrita. inserir (predefinido) Não writeBehavior
Escrever o tamanho do lote O número de linhas a inserir na tabela MySQL por lote. O valor permitido é inteiro (número de linhas). < inteiro >
10000 (padrão)
Não writeBatchSize
Tempo limite de gravação em lote O tempo de espera para que a operação de inserção em lote termine antes de atingir o tempo limite. O valor permitido é intervalo de tempo. < Período de tempo >
00:00:30 (padrão)
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. O valor permitido é inteiro. < inteiro > Não maxConcurrentConnections