Gegevens kopiëren van en naar ODBC-gegevensarchieven met behulp van Azure Data Factory of Synapse Analytics

Van toepassing op: Azure Data Factory Azure Synapse Analytics

In dit artikel wordt beschreven hoe u de kopieeractiviteit in Azure Data Factory kunt gebruiken om gegevens van en naar een ODBC-gegevensarchief te kopiëren. Het is gebaseerd op het artikel 'Overzicht kopieeractiviteit', waarin een algemeen overzicht van de kopieeractiviteit wordt gegeven.

Ondersteunde mogelijkheden

Deze ODBC-connector wordt ondersteund voor de volgende mogelijkheden:

(1) Azure Integration Runtime (2) Zelf-gehoste Integration Runtime

Zie de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks.

Deze ODBC-connector ondersteunt het kopiëren van gegevens van/naar alle ODBC-compatibele gegevensarchieven met behulp van Basis - of Anonieme verificatie. Er is een 64-bits ODBC-stuurprogramma vereist. Voor ODBC-sink ondersteunt de service ODBC versie 2.0 standard.

Vereisten

Als u deze ODBC-connector wilt gebruiken, moet u het volgende doen:

• Stel een zelf-hostende Integration Runtime in. Zie Self-hosted Integration Runtime artikel voor meer informatie.
• Installeer het 64-bits ODBC-stuurprogramma voor het gegevensarchief op de Integration Runtime computer.

Aan de slag

Als u de kopieeractiviteit wilt uitvoeren met een pijplijn, kunt u een van de volgende hulpprogramma's of SDK's gebruiken:

• Tool Gegevens kopiëren
• Azure-portal
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure Resource Manager sjabloon

Een gekoppelde service maken voor een ODBC-gegevensarchief met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor een ODBC-gegevensarchief in de gebruikersinterface van de Azure-portal.

1. Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:

   • Azure Data Factory
   • Azure Synapse

   

2. Zoek naar ODBC en selecteer de ODBC-connector.

   

3. Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

   

De configuratiedetails van de connector

De volgende secties bevatten details over eigenschappen die worden gebruikt voor het definiëren van Data Factory-entiteiten die specifiek zijn voor ODBC-connector.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor de gekoppelde ODBC-service:

Voorbeeld 1: basisverificatie gebruiken

{
    "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"
        }
    }
}

Voorbeeld 2: anonieme verificatie gebruiken

{
    "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"
        }
    }
}

Eigenschappen van gegevensset

Zie het artikel gegevenssets voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van gegevenssets . Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de ODBC-gegevensset.

Als u gegevens wilt kopiëren van/naar odbc-compatibel gegevensarchief, worden de volgende eigenschappen ondersteund:

Voorbeeld

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

Als u RelationalTable getypte gegevensset gebruikt, wordt deze nog steeds ondersteund terwijl u wordt aangeraden de nieuwe gegevensset te gebruiken.

Copy activity eigenschappen

Zie het artikel Pijplijnen voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van activiteiten. Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de ODBC-bron.

ODBC als bron

Als u gegevens wilt kopiëren uit het odBC-compatibele gegevensarchief, worden de volgende eigenschappen ondersteund in de sectie bron van de kopieeractiviteit:

Voorbeeld:

"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>"
            }
        }
    }
]

Als u RelationalSource getypte bron gebruikt, wordt deze nog steeds ondersteund, terwijl u wordt aangeraden de nieuwe bron te gebruiken.

ODBC als sink

Als u gegevens wilt kopiëren naar een met ODBC compatibel gegevensarchief, stelt u het sinktype in de kopieeractiviteit in op OdbcSink. De volgende eigenschappen worden ondersteund in de sectie sink voor kopieeractiviteit:

Voorbeeld:

"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
            }
        }
    }
]

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, raadpleegt u de opzoekactiviteit.

Verbindingsproblemen oplossen

Als u verbindingsproblemen wilt oplossen, gebruikt u het tabblad Diagnostics van Integration Runtime Configuration Manager.

1. Start Integration Runtime Configuration Manager.
2. Ga naar het tabblad Diagnostische gegevens.
3. Selecteer in de sectie Verbinding testen het type gegevensarchief (gekoppelde service).
4. Geef de connection string op die wordt gebruikt om verbinding te maken met het gegevensarchief; kies de authentication en voer gebruikernaam, password en/of credentials in.
5. Klik op Verbinding testen om de verbinding met het gegevensarchief te testen.

Gerelateerde inhoud

Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.