Copiar dados de e para armazenamentos de dados ODBC usando Azure Data Factory ou Synapse Analytics

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo explica como usar a Atividade de Cópia no Azure Data Factory para copiar dados de e para um armazenamento de dados ODBC. 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.

Capacidades suportadas

Este conector ODBC é suportado para as seguintes funcionalidades:

(1) Runtime de integração Azure (2) Runtime de integração auto-hospedado

Para obter uma lista de armazenamentos de dados suportados como fontes/coletores, consulte a tabela Armazenamentos de dados suportados.

Especificamente, esse conector ODBC suporta a cópia de dados de/para qualquer armazenamento de dados compatível com ODBC usando autenticação básica ou anônima. É necessário um driver ODBC de 64 bits. Para o coletor ODBC, o serviço suporta o padrão ODBC versão 2.0.

Pré-requisitos

Para usar esse conector ODBC, você precisa:

• Configurar um Self-hosted Integration Runtime. Consulte o artigo Self-hosted Integration Runtime para mais detalhes.
• Instale o driver ODBC de 64 bits para o armazenamento de dados na máquina de Integration Runtime.

Começar

Para executar a atividade de cópia com um pipeline, você pode usar uma das seguintes ferramentas ou SDKs:

• Ferramenta Copiar dados
• Portal do Azure
• .NET SDK
• Python SDK
• Azure PowerShell
• API REST
• Modelo do Azure Resource Manager

Criar um serviço vinculado a um armazenamento de dados ODBC usando a interface do usuário

Use os seguintes passos para criar um serviço ligado a um armazenamento de dados ODBC na interface do portal Azure.

1. Navegue até ao separador Gerir no seu espaço de trabalho Azure Data Factory ou Synapse e selecione Serviços Ligados, depois clique em Novo:

   • Azure Data Factory
   • Azure Synapse

   

2. Procure ODBC e selecione o conector ODBC.

   

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

   

Detalhes de configuração do conector

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

Propriedades do serviço vinculado

As seguintes propriedades são suportadas para o serviço vinculado ODBC:

Exemplo 1: usando a autenticação básica

{
    "name": "ODBCLinkedService",
    "properties": {
        "type": "Odbc",
        "typeProperties": {
            "connectionString": "<connection string>",
            "authenticationType": "Basic",
            "userName": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exemplo 2: usando a autenticação anônima

{
    "name": "ODBCLinkedService",
    "properties": {
        "type": "Odbc",
        "typeProperties": {
            "connectionString": "<connection string>",
            "authenticationType": "Anonymous",
            "credential": {
                "type": "SecureString",
                "value": "RefreshToken=<secret refresh token>;"
            }
        },
        "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 ODBC.

Para copiar dados de/para o armazenamento de dados compatível com ODBC, as seguintes propriedades são suportadas:

Exemplo

{
    "name": "ODBCDataset",
    "properties": {
        "type": "OdbcTable",
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<ODBC linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties": {
            "tableName": "<table name>"
        }
    }
}

Se estiver a utilizar RelationalTable o conjunto de dados tipificado, ele ainda é suportado tal como está, mas recomenda-se usar o novo no futuro.

Propriedades da atividade de cópia

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

ODBC como fonte

Para copiar dados de um armazenamento de dados compatível com ODBC, as seguintes propriedades são suportadas na secção de origem da atividade de cópia:

Exemplo:

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

Se estiveres a usar RelationalSource fonte digitada, ela ainda é suportada como está, mas recomenda-se que utilizes a nova versão no futuro.

ODBC como sumidouro

Para copiar dados para armazenamento de dados compatível com ODBC, defina o tipo de coletor na atividade de cópia como OdbcSink. As seguintes propriedades são suportadas na seção coletor de atividade de cópia:

Exemplo:

"activities":[
    {
        "name": "CopyToODBC",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<ODBC output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "OdbcSink",
                "writeBatchSize": 100000
            }
        }
    }
]

Propriedades da atividade de consulta

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

Resolver problemas de conectividade

Para resolver problemas de ligação, use o separador Diagnostics do Integration Runtime Gestor de Configuração.

1. Lançar Integration Runtime Gestor de Configuração.
2. Mude para o separador Diagnósticos.
3. Na seção "Testar conexão", selecione o tipo de armazenamento de dados (serviço vinculado).
4. Especifique o cadeia de ligação usado para se ligar ao armazenamento de dados, escolha o autenticação e insira nome de utilizador, password e/ou c4.
5. Clique em Testar conexão para testar a conexão com o armazenamento de dados.

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.