Copiar dados do MariaDB utilizando o Azure Data Factory ou o Synapse Analytics

Artigo
10/29/2024

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

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

Este artigo descreve como usar a atividade de cópia nos pipelines do Azure Data Factory ou do Azure Synapse Analytics para copiar dados de uma tabela do MariaDB. Ele amplia o artigo 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 nativo aprimorado ao MariaDB. Se você estiver usando o conector com a versão herdada do driver, 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.

Funcionalidades com suporte

Este conector MariaDB é compatível com os seguintes recursos:

Funcionalidades com suporte	IR
Atividade de cópia (origem/-)	① ②
Atividade de pesquisa	① ②

① Runtime de integração do Azure ② Runtime de integração auto-hospedada

Para obter uma lista de armazenamentos de dados com suporte como origens/coletores da atividade de cópia, confira a tabela Armazenamentos de dados com suporte.

O serviço fornece um driver interno para habilitar a conectividade, portanto, não é necessário instalar manualmente qualquer driver usando esse conector.

Atualmente, esse conector dá suporte ao MariaDB da versão 10.x, 11.x na nova versão recomendada do driver v2 e da versão 10.0 à 10.5 na versão herdada do driver.

Pré-requisitos

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

Se o armazenamento de dados for um serviço de dados de nuvem gerenciado, você poderá usar o Azure Integration Runtime. Se o acesso for restrito aos IPs que estão 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 runtime de integração da rede virtual gerenciada no Azure Data Factory para acessar a rede local sem instalar e configurar um runtime de integração auto-hospedada.

Para obter mais informações sobre os mecanismos de segurança de rede e as opções compatíveis com o Data Factory, consulte Estratégias de acesso a dados.

Introdução

Para executar a atividade de Cópia com um pipeline, será possível usar as ferramentas ou os SDKs abaixo:

Criar um serviço vinculado para o MariaDB usando a interface do usuário

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

Navegue até a guia Gerenciar no workspace do Azure Data Factory ou do Synapse, selecione Serviços Vinculados e clique em Novo:
- Azure Data Factory
- Azure Synapse
Procure Maria e selecione o conector do MariaDB.
Configure os detalhes do serviço, teste a conexão e crie o novo serviço vinculado.

Detalhes da configuração do conector

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

Propriedades do serviço vinculado

Se você usar a versão recomendada do driver, as seguintes propriedades terão suporte no serviço vinculado do MariaDB:

Propriedade	Descrição	Obrigatório
type	A propriedade type deve ser definida como: MariaDB	Sim
driverVersion	A versão do driver quando você seleciona a versão recomendada do driver. O valor é v2.	Sim
Servidor	O nome do servidor MariaDB.	Sim
porta	O número da porta a ser conectado ao servidor MariaDB.	Não
Banco de Dados	O nome do banco de dados MariaDB.	Sim
Nome de Usuário	Seu nome de usuário.	Sim
password	A senha do nome de usuário. Marque esse campo como SecureString para armazená-lo com segurança. Você também pode referenciar um segredo armazenado no Azure Key Vault.	Sim
sslMode	Esta opção especifica se o driver usa verificação e criptografia TLS ao se conectar ao MariaDB. Por exemplo, `SSLMode=<0/1/2/3/4>`. Opções: DESATIVADO (0)/PREFERENCIAL (1)/OBRIGATÓRIO (2)/VERIFICAR_CA (3)/VERIFICAR_IDENTIDADE (4) (Padrão)	Sim
useSystemTrustStore	Esta opção especifica se deve usar um certificado de autoridade de certificação do repositório de confiança de sistema ou de um arquivo PEM especificado. Por exemplo, `UseSystemTrustStore=<0/1>`; Opções: Ativado (1)/Desativado (0) (Padrão)	Não
connectVia	O Integration Runtime a ser usado para se conectar ao armazenamento de dados. Saiba mais na seção Pré-requisitos. Se não for especificado, ele usa o Integration Runtime padrão do Azure.	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 a senha no Azure Key Vault

{
    "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 terão suporte:

Propriedade	Descrição	Obrigatório
type	A propriedade type deve ser definida como: MariaDB	Sim
connectionString	Uma cadeia de conexão ODBC para conectar-se ao MariaDB. Você também pode colocar uma senha no Azure Key Vault e extrair a configuração `pwd` da cadeia de conexão. Confira os exemplos a seguir e o artigo Armazenar credenciais no Azure Key Vault com mais detalhes.	Sim
connectVia	O Integration Runtime a ser usado para se conectar ao armazenamento de dados. Saiba mais na seção Pré-requisitos. Se não for especificado, ele usa o Integration Runtime padrão do Azure.	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 das seções e propriedades disponíveis para definir os conjuntos de dados, confira o artigo sobre conjuntos de dados. Esta seção fornece uma lista das propriedades com suporte pelo conjunto de dados do MariaDB.

Para copiar dados do MariaDB, defina a propriedade type do conjunto de dados como MariaDBTable. Não há nenhuma propriedade adicional específica do type 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 de cópia

Para obter uma lista completa das seções e propriedades disponíveis para definir atividades, confia o artigo Pipelines. Esta seção fornece uma lista das propriedades com suporte pela origem do MariaDB.

MariaDB como fonte

Para copiar dados do MariaDB, defina o tipo de fonte na atividade de cópia como MariaDbSource. As propriedades a seguir têm suporte na seção source da atividade de cópia:

Propriedade	Descrição	Obrigatório
type	A propriedade type da fonte da atividade de cópia deve ser definida como: MariaDBSource	Sim
Consulta	Utiliza a consulta SQL personalizada para ler os 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 o MariaDB

Durante a cópia de dados do MariaDB, são usados estes mapeamentos dos tipos de dados do MariaDB para os tipos de dados provisórios usados internamente pelo serviço. Consulte Mapeamentos de tipo de dados e esquema para saber mais sobre como a atividade de cópia mapeia o tipo de dados e esquema de origem para o coletor.

Tipo de dados do MariaDB	Tipo de dados provisório do serviço	Tipo de dados provisórios do serviço (para a versão herdada do driver)
`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, será mapeado como `SByte`. TreatTinyAsBoolean é true 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`

Pesquisar propriedades de atividade

Para saber detalhes sobre as propriedades, verifique Pesquisar atividade.

Atualizar o conector MariaDB

Estas são as etapas que ajudarão você a atualizar o conector MariaDB:

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.
O mapeamento de tipo de dados para o serviço vinculado mais recente do MariaDB é diferente daquele da versão herdada. Para conhecer o mapeamento de tipo de dados mais recente, confira Mapeamento de tipo de dados do MariaDB.
A versão mais recente do driver v2 dá suporte a mais versões do MariaDB. Para obter mais informações, confira Funcionalidades com suporte.

Diferenças entre a versão recomendada e a versão do driver herdado

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

Tipo de dados do MariaDB	Tipo de dados de serviço provisório (usando a versão recomendada do driver)	Tipo de dados provisórios do serviço (para a versão herdada do driver)
bit(1)	UInt64	Booliano
bit(M), M>1	UInt64	Byte[]
bool	Booliano	Int16
JSON	String	Byte[]

Para obter uma lista de armazenamentos de dados com suporte como coletores e fontes da atividade de cópia, confira os armazenamentos de dados com suporte.

Compartilhar via

Copiar dados do MariaDB utilizando o Azure Data Factory ou o Synapse Analytics

Funcionalidades com suporte

Pré-requisitos

Introdução

Criar um serviço vinculado para o MariaDB usando a interface do usuário

Detalhes da configuração do conector

Propriedades do serviço vinculado

Propriedades do conjunto de dados

Propriedades da atividade de cópia

MariaDB como fonte

Mapeamento de tipo de dados para o MariaDB

Pesquisar propriedades de atividade

Atualizar o conector MariaDB

Diferenças entre a versão recomendada e a versão do driver herdado

Comentários

Recursos adicionais

Compartilhar via

Copiar dados do MariaDB utilizando o Azure Data Factory ou o Synapse Analytics

Funcionalidades com suporte

Pré-requisitos

Introdução

Criar um serviço vinculado para o MariaDB usando a interface do usuário

Detalhes da configuração do conector

Propriedades do serviço vinculado

Propriedades do conjunto de dados

Propriedades da atividade de cópia

MariaDB como fonte

Mapeamento de tipo de dados para o MariaDB

Pesquisar propriedades de atividade

Atualizar o conector MariaDB

Diferenças entre a versão recomendada e a versão do driver herdado

Conteúdo relacionado

Comentários

Recursos adicionais