Partilhar via

Copiar dados do MariaDB 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 em um pipeline do Azure Data Factory ou do Synapse Analytics para copiar dados do MariaDB. 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.

Importante

O conector MariaDB usando a versão recomendada do driver fornece suporte MariaDB nativo aprimorado. 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 MariaDB é 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.

O serviço fornece um driver interno para habilitar a conectividade, portanto, você não precisa instalar manualmente nenhum driver usando esse conector.

Este conector atualmente suporta MariaDB da versão 10.x, 11.x sob a nova versão de driver recomendada v2 e 10.0 a 10.5 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.

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 MariaDB usando a interface do usuário

Use as etapas a seguir para criar um serviço vinculado ao MariaDB 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 Maria e selecione o conector MariaDB.

    Captura de tela do conector MariaDB.

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

    Captura de tela da configuração do serviço vinculado para MariaDB.

Detalhes de configuração do conector

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

Propriedades do serviço vinculado

Se você usar a versão de driver recomendada, as seguintes propriedades serão suportadas para o serviço vinculado MariaDB:

Property Descrição Obrigatório
tipo A propriedade type deve ser definida como: MariaDB 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 MariaDB Server. Sim
porta O número da porta para se conectar ao servidor MariaDB. Não
base de dados Seu nome de banco de dados MariaDB. 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 MariaDB. Por exemplo, SSLMode=<0/1/2/3/4>.
Opções: DESATIVADO (0) / PREFERENCIAL (1) / OBRIGATÓRIO (2) / VERIFY_CA (3) / VERIFY_IDENTITY (4) (Padrão)		 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

Exemplo:

{
    "name": "MariaDBLinkedService",
    "properties": {
        "type": "MariaDB",
        "typeProperties": {
            "server": "<server>",
            "port": "<port>",
            "database": "<database>",
            "username": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            },
            "driverVersion": "v2",
            "sslMode": <sslmode>,
            "useSystemTrustStore": <UseSystemTrustStore>
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exemplo: armazenar senha no Cofre da Chave do Azure

{
    "name": "MariaDBLinkedService",
    "properties": {
        "type": "MariaDB",
        "typeProperties": {
            "server": "<server>",
            "port": "<port>",
            "database": "<database>",
            "username": "<username>",
            "password": {
                "type": "AzureKeyVaultSecret",
                "store": {
                    "referenceName": "<Azure Key Vault linked service name>",
                    "type": "LinkedServiceReference"
                },
                "secretName": "<secretName>"
            },
            "driverVersion": "v2",
            "sslMode": <sslmode>,
            "useSystemTrustStore": <UseSystemTrustStore>
        },
        "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: MariaDB Sim
connectionString Uma cadeia de conexão ODBC para se conectar ao MariaDB.
Você também pode colocar a senha no Cofre de Chaves do Azure e extrair a pwd 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

Exemplo:

{
    "name": "MariaDBLinkedService",
    "properties": {
        "type": "MariaDB",
        "typeProperties": {
            "connectionString": "Server=<host>;Port=<port>;Database=<database>;UID=<user name>;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 MariaDB.

Para copiar dados do MariaDB, defina a propriedade type do conjunto de dados como MariaDBTable. Não há nenhuma propriedade específica de tipo adicional nesse tipo de conjunto de dados.

Exemplo

{
    "name": "MariaDBDataset",
    "properties": {
        "type": "MariaDBTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<MariaDB linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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 MariaDB.

MariaDB como fonte

Para copiar dados do MariaDB, defina o tipo de origem na atividade de cópia como MariaDBSource. As seguintes propriedades são suportadas na seção de origem da atividade de cópia:

Property Descrição Obrigatório
tipo A propriedade type da fonte de atividade de cópia deve ser definida como: MariaDBSource 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": "CopyFromMariaDB",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<MariaDB input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "MariaDBSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Mapeamento de tipo de dados para MariaDB

Ao copiar dados do MariaDB, os mapeamentos a seguir são usados de tipos de dados MariaDB 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 MariaDB 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 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.

Atualizar o conector MariaDB

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

  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 MariaDB mais recente é diferente do da versão herdada. Para aprender o mapeamento de tipo de dados mais recente, consulte Mapeamento de tipo de dados para MariaDB.

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

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

Tipo de dados MariaDB 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.