Partilhar via

Copiar dados do MySQL usando o Azure Data Factory ou o Synapse Analytics

  • Artigo

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!

Este artigo descreve como usar a Atividade de Cópia no Azure Data Factory e os pipelines do Synapse Analytics para copiar dados de um banco de dados MySQL. Ele se baseia no artigo de visão geral da atividade de cópia que apresenta uma visão geral da atividade de cópia.

Nota

Para copiar dados de ou para o serviço Banco de Dados do Azure para MySQL, use o conector especializado do Banco de Dados do Azure para MySQL.

Importante

O conector MySQL usando a versão recomendada do driver fornece suporte nativo aprimorado ao MySQL. Se você estiver usando o conector com a versão do driver herdado, atualize-o antes de 31 de outubro de 2024. Consulte esta seção para obter detalhes sobre a diferença entre a versão herdada e a versão recomendada.

Capacidades suportadas

Este conector MySQL é suportado para os seguintes recursos:

Capacidades suportadas IR
Atividade de cópia (fonte/-) (1) (2)
Atividade de Pesquisa (1) (2)

(1) Tempo de execução de integração do Azure (2) Tempo de execução de integração auto-hospedado

Para obter uma lista de armazenamentos de dados suportados como fontes/coletores pela atividade de cópia, consulte a tabela Armazenamentos de dados suportados.

Este conector suporta MySQL versão 5.5, 5.6, 5.7, 8.0, 8.1 e 8.2 sob a nova versão de driver recomendada v2 e 5.6, 5.7 e 8.0 para a versão de driver herdado.

Pré-requisitos

Se seu armazenamento de dados estiver localizado dentro de uma rede local, uma rede virtual do Azure ou a Amazon Virtual Private Cloud, você precisará configurar um tempo de execução de integração auto-hospedado para se conectar a ele.

Se o seu armazenamento de dados for um serviço de dados de nuvem gerenciado, você poderá usar o Tempo de Execução de Integração do Azure. Se o acesso for restrito a IPs aprovados nas regras de firewall, você poderá adicionar IPs do Azure Integration Runtime à lista de permissões.

Você também pode usar o recurso de tempo de execução de integração de rede virtual gerenciada no Azure Data Factory para acessar a rede local sem instalar e configurar um tempo de execução de integração auto-hospedado.

Para obter mais informações sobre os mecanismos de segurança de rede e as opções suportadas pelo Data Factory, consulte Estratégias de acesso a dados.

O Integration Runtime fornece um driver MySQL integrado a partir da versão 3.7, portanto, você não precisa instalar manualmente nenhum driver.

Introdução

Para executar a atividade Copiar com um pipeline, você pode usar uma das seguintes ferramentas ou SDKs:

Criar um serviço vinculado ao MySQL usando a interface do usuário

Use as etapas a seguir para criar um serviço vinculado ao MySQL na interface do usuário do portal do Azure.

  1. Navegue até a guia Gerenciar em seu espaço de trabalho do Azure Data Factory ou Synapse e selecione Serviços Vinculados e clique em Novo:

  2. Procure por MySQL e selecione o conector MySQL.

    Selecione o conector MySQL.

  3. Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.

    Configure um serviço vinculado ao MySQL.

Detalhes de configuração do conector

As seções a seguir fornecem detalhes sobre as propriedades que são usadas para definir entidades do Data Factory específicas para o conector MySQL.

Propriedades do serviço vinculado

Se você usar a versão recomendada do driver, as seguintes propriedades são suportadas para o serviço vinculado MySQL:

Property Descrição Obrigatório
tipo A propriedade type deve ser definida como: MySql Sim
driverVersão A versão do driver quando você seleciona a versão recomendada do driver. O valor é v2. Sim
servidor O nome do seu servidor MySQL. Sim
porta O número da porta para se conectar ao servidor MySQL. Não
base de dados Seu nome de banco de dados MySQL. Sim
nome de utilizador O seu nome de utilizador. Sim
password A senha para o nome de usuário. Marque este campo como SecureString para armazená-lo com segurança. Ou, você pode fazer referência a um segredo armazenado no Cofre da Chave do Azure. Sim
sslMode Esta opção especifica se o driver usa criptografia e verificação TLS ao se conectar ao MySQL. Por exemplo, SSLMode=<0/1/2/3/4>.
Opções: DESATIVADO (0) / PREFERENCIAL (1) (Padrão) / OBRIGATÓRIO (2) / VERIFY_CA (3) / VERIFY_IDENTITY (4)		 Sim
useSystemTrustStore Esta opção especifica se um certificado de autoridade de certificação do armazenamento confiável do sistema deve ser usado ou de um arquivo PEM especificado. Por exemplo; UseSystemTrustStore=<0/1>
Opções: Ativado (1) / Desativado (0) (Padrão)		 Não
ConecteVia O tempo de execução de integração a ser usado para se conectar ao armazenamento de dados. Saiba mais na seção Pré-requisitos . Se não for especificado, ele usará o Tempo de Execução de Integração do Azure padrão. Não
Propriedades de conexão adicionais
allowZeroDateTime Especificar esse valor de propriedade para true permitir que o valor de data "zero" especial de seja recuperado do banco de 0000-00-00 dados. Se definido como false (o padrão), as colunas de data são retornadas como valores DateTime, o que significa 0000-00-00 que não podem ser recuperadas.

O MySQL permite que você armazene um valor "zero" como 0000-00-00 uma "data fictícia". Em alguns casos, esse recurso é mais conveniente do que usar valores NULL e usa menos dados e espaço de índice. Para não permitir 0000-00-00 no MySQL, ative o modo NO_ZERO_DATE . Para mais informações, consulte este artigo.		 Não
connectionTimeout O período de tempo (em segundos) para aguardar uma conexão com o servidor antes de encerrar a tentativa e gerar um erro. Não
convertZeroDateTime Defina-o como true retornando DateTime.MinValue para colunas de data ou datetime que não permitiram valores. Não
guidFormato Determina qual tipo de coluna (se houver) deve ser lido como um GUID. Vá para este artigo para obter a descrição de cada tipo de coluna pesquisando esta propriedade.

A versão recomendada trata Char(36) como tipo GUID por padrão para melhor desempenho. O conector trata os campos Char(36) como GUIDs para facilitar o tratamento do banco de dados. Esse tratamento simplifica operações como inserir, atualizar e recuperar valores GUID, garantindo que eles sejam gerenciados consistentemente como objetos GUID no código do aplicativo em vez de cadeias de caracteres simples. Esse comportamento é particularmente útil em cenários onde GUIDs são usados como chaves primárias ou identificadores exclusivos e fornece melhor desempenho. Se você não precisar dessa configuração padrão, poderá configurar guidFormat=none na propriedade de conexão.		 Não
sslCert O caminho para o arquivo de certificado SSL do cliente no formato PEM. SslKey também deve ser especificado. Não
sslKey O caminho para a chave privada SSL do cliente no formato PEM. SslCert também deve ser especificado. Não
tratarTinyAsBoolean Quando definido como true, os valores tinyint(1) são retornados como booleanos. Definir essa propriedade como false faz com que tinyint(1) seja retornado como SByte/Byte.

A versão recomendada trata tinyint(1) como tipo booleano por padrão. Para mais informações, consulte este artigo. Para permitir que o conector retorne minúsculo como numérico, defina treatTinyAsBoolean=false nas propriedades da conexão.		 Não

Exemplo:

{
    "name": "MySQLLinkedService",
    "properties": {
        "type": "MySql",
        "typeProperties": {
             "server": "<server>",
             "port": 3306,
             "database": "<database>",
             "username": "<username>",
             "password": {
                "type": "SecureString",
                "value": "<password>"
             },
             "sslmode": <sslmode>,
             "usesystemtruststore": <UseSystemTrustStore>,
             "driverVersion": "v2"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exemplo: armazenar senha no Cofre da Chave do Azure

{
    "name": "MySQLLinkedService",
    "properties": {
        "type": "MySql",
        "typeProperties": {
            "server": "<server>",
            "port": 3306,
            "database": "<database>",
            "username": "<username>",
            "sslmode": <sslmode>,
            "usesystemtruststore": <UseSystemTrustStore>,
            "password": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            },
            "driverVersion": "v2"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Se você usar a versão herdada do driver, as seguintes propriedades serão suportadas:

Property Descrição Obrigatório
tipo A propriedade type deve ser definida como: MySql Sim
connectionString Especifique as informações necessárias para se conectar ao Banco de Dados do Azure para a instância do MySQL.
Você também pode colocar a senha no Cofre de Chaves do Azure e extrair a password configuração da cadeia de conexão. Consulte os seguintes exemplos e o artigo Armazenar credenciais no Cofre de Chaves do Azure com mais detalhes.		 Sim
ConecteVia O tempo de execução de integração a ser usado para se conectar ao armazenamento de dados. Saiba mais na seção Pré-requisitos . Se não for especificado, ele usará o Tempo de Execução de Integração do Azure padrão. Não

Uma cadeia de conexão típica é Server=<server>;Port=<port>;Database=<database>;UID=<username>;PWD=<password>. Mais propriedades que pode definir de acordo com o seu caso:

Property Descrição Obrigatório
sslMode Esta opção especifica se o driver usa criptografia e verificação TLS ao se conectar ao MySQL. Por exemplo, SSLMode=<0/1/2/3/4>.
Opções: DESATIVADO (0) / PREFERENCIAL (1) (Padrão) / OBRIGATÓRIO (2) / VERIFY_CA (3) / VERIFY_IDENTITY (4)		 Sim
SSLCert O caminho completo e o nome de um arquivo .pem contendo o certificado SSL usado para provar a identidade do cliente.
Para especificar uma chave privada para criptografar esse certificado antes de enviá-lo ao servidor, use a SSLKey propriedade.		 Sim, se estiver usando a verificação SSL bidirecional.
SSLKey O caminho completo e o nome de um arquivo que contém a chave privada usada para criptografar o certificado do lado do cliente durante a verificação SSL bidirecional. Sim, se estiver usando a verificação SSL bidirecional.
useSystemTrustStore Esta opção especifica se um certificado de autoridade de certificação do armazenamento confiável do sistema deve ser usado ou de um arquivo PEM especificado. Por exemplo; UseSystemTrustStore=<0/1>
Opções: Ativado (1) / Desativado (0) (Padrão)		 Não

Exemplo:

{
    "name": "MySQLLinkedService",
    "properties": {
        "type": "MySql",
        "typeProperties": {
            "connectionString": "Server=<server>;Port=<port>;Database=<database>;UID=<username>;PWD=<password>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Propriedades do conjunto de dados

Para obter uma lista completa de seções e propriedades disponíveis para definir conjuntos de dados, consulte o artigo sobre conjuntos de dados. Esta seção fornece uma lista de propriedades suportadas pelo conjunto de dados MySQL.

Para copiar dados do MySQL, as seguintes propriedades são suportadas:

Property Descrição Obrigatório
tipo A propriedade type do conjunto de dados deve ser definida como: MySqlTable Sim
tableName Nome da tabela no banco de dados MySQL. Não (se "consulta" na fonte da atividade for especificado)

Exemplo

{
    "name": "MySQLDataset",
    "properties":
    {
        "type": "MySqlTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<MySQL linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Se você estava usando RelationalTable o conjunto de dados digitado, ele ainda é suportado no estado em que se encontra, enquanto é sugerido que você use o novo no futuro.

Propriedades da atividade Copy

Para obter uma lista completa de seções e propriedades disponíveis para definir atividades, consulte o artigo Pipelines . Esta seção fornece uma lista de propriedades suportadas pela fonte MySQL.

MySQL como fonte

Para copiar dados do MySQL, as seguintes propriedades são suportadas na seção de fonte de atividade de cópia:

Property Descrição Obrigatório
tipo A propriedade type da fonte de atividade de cópia deve ser definida como: MySqlSource Sim
query Use a consulta SQL personalizada para ler dados. Por exemplo: "SELECT * FROM MyTable". Não (se "tableName" no conjunto de dados for especificado)

Exemplo:

"activities":[
    {
        "name": "CopyFromMySQL",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<MySQL input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "MySqlSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Se você estava usando RelationalSource fonte digitada, ela ainda é suportada como está, enquanto você é sugerido para usar a nova no futuro.

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 provisórios usados pelo serviço internamente. Consulte Mapeamentos de esquema e tipo de dados para saber como a atividade de cópia mapeia o esquema de origem e o tipo de dados para o coletor.

Tipo de dados MySQL Tipo de dados de serviço provisório Tipo de dados de serviço provisório (para a versão do driver herdado)
bigint Int64 Int64
bigint unsigned Decimal Decimal
bit(1) UInt64 Boolean
bit(M), M>1 UInt64 Byte[]
blob Byte[] Byte[]
bool Boolean
(Se TreatTinyAsBoolean=false, ele é mapeado como SByte. TreatTinyAsBoolean é verdadeiro por padrão :)		 Int16
char String String
date Datetime Datetime
datetime Datetime Datetime
decimal Decimal Decimal, String
double Double Double
double precision Double Double
enum String String
float Single Single
int Int32 Int32
int unsigned Int64 Int64
integer Int32 Int32
integer unsigned Int64 Int64
JSON String -
long varbinary Byte[] Byte[]
long varchar String String
longblob Byte[] Byte[]
longtext String String
mediumblob Byte[] Byte[]
mediumint Int32 Int32
mediumint unsigned Int64 Int64
mediumtext String String
numeric Decimal Decimal
real Double Double
set String String
smallint Int16 Int16
smallint unsigned Int32 Int32
text String String
time TimeSpan TimeSpan
timestamp Datetime Datetime
tinyblob Byte[] Byte[]
tinyint SByte
tinyint(1)( está mapeado para Boolean)		 Int16
tinyint unsigned Int16 Int16
tinytext String String
varchar String String
year Int Int

Propriedades da atividade de pesquisa

Para saber detalhes sobre as propriedades, verifique Atividade de pesquisa.

Atualize o conector MySQL

Aqui estão as etapas que ajudam você a atualizar seu conector MySQL:

  1. Na página Editar serviço vinculado, selecione Recomendado em Versão do driver e configure o serviço vinculado consultando as propriedades do serviço vinculado.

  2. O mapeamento de tipo de dados para o serviço vinculado MySQL mais recente é diferente daquele para a versão herdada. Para aprender o mapeamento de tipo de dados mais recente, consulte Mapeamento de tipo de dados para MySQL.

  3. A última versão do driver v2 suporta mais versões do MySQL. Para obter mais informações, consulte Recursos suportados.

Esta seção apresenta as melhores práticas para a versão recomendada do conector MySQL.

Não é possível carregar a chave SSL

  • Sintomas: Se você estiver usando a versão recomendada do conector MySQL com a chave SSL como uma propriedade de conexão, você pode atender à seguinte mensagem de erro: Could not load the client key from your_pem_file: Unrecognized PEM header: -----BEGIN PRIVATE KEY-----

  • Causa: A versão recomendada não pode desencriptar o formato PCKS#8.

  • Recomendação: Converta o formato PEM para PCKS#1.

A tabela abaixo mostra as diferenças de mapeamento de tipo de dados entre o MySQL usando a versão recomendada e a versão do driver herdado.

Tipo de dados MySQL Tipo de dados de serviço provisório (usando a versão recomendada do driver) Tipo de dados de serviço provisório (usando a versão do driver herdado)
bit(1) UInt64 Boolean
bit (M), M>1 UInt64 Byte[]
booleano Boolean Int16
JSON String Byte[]

Conteúdos relacionados

Para obter uma lista de armazenamentos de dados suportados como fontes e coletores pela atividade de cópia, consulte Armazenamentos de dados suportados.