Gegevens kopiëren van en naar IBM Informix met behulp van Azure Data Factory of Synapse Analytics

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u de kopieeractiviteit gebruikt in een Azure Data Factory- of Synapse Analytics-pijplijn om gegevens te kopiëren uit een IBM Informix-gegevensarchief. Het is gebaseerd op het artikel over het overzicht van kopieeractiviteiten met een algemeen overzicht van de kopieeractiviteit.

Ondersteunde mogelijkheden

Deze Informix-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden	IR
Copy-activiteit (bron/sink)	(2)
Activiteit Lookup	(2)

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

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

Vereisten

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

• Stel een zelf-hostende Integration Runtime in. Zie het artikel over zelf-hostende Integration Runtime voor meer informatie.
• Download de 64-bits client-SDK voor Informix om een ODBC-verbinding te maken voor het gegevensarchief op de Integration Runtime-computer. Raadpleeg dit artikel voor het downloaden en instellen van sdk's voor meer informatie of neem contact op met het ondersteuningsteam van IBM voor richtlijnen voor de installatie van stuurprogramma's.

Aan de slag

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

• Het hulpprogramma voor het kopiëren van gegevens
• Azure Portal
• De .NET-SDK
• De Python-SDK
• Azure PowerShell
• De REST API
• Een Azure Resource Manager-sjabloon

Een gekoppelde service maken voor Informix met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor Informix in de gebruikersinterface van 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 Informix en selecteer de Informix-connector.

   

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

   

Configuratiedetails van connector

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

Eigenschappen van gekoppelde service

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

Eigenschappen	Beschrijving	Vereist
type	De eigenschap type moet worden ingesteld op: Informix	Ja
connectionString	De ODBC-verbindingsreeks exclusief het referentiegedeelte. U kunt de verbindingsreeks opgeven of de systeem-DSN (naam van gegevensbron) gebruiken die u hebt ingesteld op de Integration Runtime-machine (u moet nog steeds het referentiegedeelte in de gekoppelde service opgeven). U kunt ook een wachtwoord in Azure Key Vault plaatsen en de password configuratie uit de verbindingsreeks halen. Raadpleeg De referenties van de Store in Azure Key Vault met meer informatie.	Ja
authenticationType	Type verificatie dat wordt gebruikt om verbinding te maken met het Informix-gegevensarchief. Toegestane waarden zijn: Basis en Anoniem.	Ja
gebruikersnaam	Geef de gebruikersnaam op als u basisverificatie gebruikt.	Nee
password	Geef het wachtwoord op voor het gebruikersaccount dat u hebt opgegeven voor de gebruikersnaam. Markeer dit veld als SecureString om het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault.	Nee
referenties	Het toegangsreferentiegedeelte van de verbindingsreeks opgegeven in de indeling van de eigenschapswaarde van het stuurprogramma. Markeer dit veld als securestring.	Nee
connectVia	De Integration Runtime die moet worden gebruikt om verbinding te maken met het gegevensarchief. Een zelf-hostende Integration Runtime is vereist, zoals vermeld in vereisten.	Ja

Voorbeeld:

{
    "name": "InformixLinkedService",
    "properties": {
        "type": "Informix",
        "typeProperties": {
            "connectionString": "<Informix connection string or DSN>",
            "authenticationType": "Basic",
            "userName": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "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 Informix-gegevensset.

Als u gegevens uit Informix wilt kopiëren, worden de volgende eigenschappen ondersteund:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap van de gegevensset moet worden ingesteld op: InformixTable	Ja
tableName	Naam van de tabel in de Informix.	Nee voor bron (als 'query' in de activiteitsbron is opgegeven); Ja voor sink

Voorbeeld

{
    "name": "InformixDataset",
    "properties": {
        "type": "InformixTable",
        "linkedServiceName": {
            "referenceName": "<Informix linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties": {
            "tableName": "<table name>"
        }
    }
}

Eigenschappen van de kopieeractiviteit

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 Informix-bron.

Informix als bron

Als u gegevens uit Informix wilt kopiëren, worden de volgende eigenschappen ondersteund in de sectie bron van de kopieeractiviteit:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap van de bron van de kopieeractiviteit moet worden ingesteld op: InformixSource	Ja
query	Gebruik de aangepaste query om gegevens te lezen. Voorbeeld: "SELECT * FROM MyTable".	Nee (als 'tableName' in de gegevensset is opgegeven)

Voorbeeld:

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

Informix als sink

Als u gegevens naar Informix wilt kopiëren, worden de volgende eigenschappen ondersteund in de sectie copy activity sink :

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap van de sink van de kopieeractiviteit moet worden ingesteld op: InformixSink	Ja
writeBatchTimeout	Wachttijd voordat de batchinvoegbewerking is voltooid voordat er een time-out optreedt. Toegestane waarden zijn: tijdspanne. Voorbeeld: '00:30:00' (30 minuten).	Nee
writeBatchSize	Hiermee worden gegevens in de SQL-tabel ingevoegd wanneer de buffergrootte writeBatchSize bereikt. Toegestane waarden zijn: geheel getal (aantal rijen).	Nee (standaard is 0 - automatisch gedetecteerd)
preCopyScript	Geef in elke uitvoering een SQL-query op voor kopieeractiviteit die moet worden uitgevoerd voordat u gegevens naar het gegevensarchief schrijft. U kunt deze eigenschap gebruiken om de vooraf geladen gegevens op te schonen.	Nee
maxConcurrentConnections	De bovengrens van gelijktijdige verbindingen die tijdens de uitvoering van de activiteit tot stand zijn gebracht met het gegevensarchief. Geef alleen een waarde op wanneer u gelijktijdige verbindingen wilt beperken.	Nee

Voorbeeld:

"activities":[
    {
        "name": "CopyToInformix",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<Informix output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "InformixSink"
            }
        }
    }
]

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, controleert u de lookup-activiteit.

Gerelateerde inhoud

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