Gegevens kopiëren van en naar Microsoft Access met behulp van Azure Data Factory of Synapse Analytics

Van toepassing op: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory in Microsoft Fabric is de volgende generatie van Azure Data Factory, met een eenvoudigere architectuur, ingebouwde AI en nieuwe functies. Als u nieuw bent in gegevensintegratie, begint u met Fabric Data Factory. Bestaande ADF-workloads kunnen upgraden naar Fabric om toegang te krijgen tot nieuwe mogelijkheden voor gegevenswetenschap, realtime analyses en rapportage.

In dit artikel wordt beschreven hoe u de kopieeractiviteit gebruikt in Azure Data Factory- en Synapse Analytics-pijplijnen om gegevens te kopiëren uit een Microsoft Access gegevensarchief. Het is gebaseerd op het artikel 'Overzicht kopieeractiviteit', waarin een algemeen overzicht van de kopieeractiviteit wordt gegeven.

Ondersteunde mogelijkheden

Deze Microsoft Access-connector wordt ondersteund voor de volgende mogelijkheden:

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

(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 door de kopieeractiviteit.

Vereisten

Als u deze Microsoft Access-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 MICROSOFT ACCESS ODBC-stuurprogramma voor het gegevensarchief op de Integration Runtime computer.

Notitie

Deze connector werkt met Microsoft Access 2016 versie van het ODBC-stuurprogramma. De aanbevolen stuurprogrammaversie is 16.00.5378.1000 of hoger.

Aan de slag

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

Een gekoppelde service maken voor Microsoft Access met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service voor Microsoft Access te maken in de UI 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:

  2. Zoek naar Access en selecteer de Microsoft Access-connector.

    Selecteer de Microsoft Access connector.

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

    Configureer een gekoppelde service aan Microsoft Access.

De configuratiedetails van de connector

De volgende secties bevatten details over eigenschappen die worden gebruikt om Data Factory-entiteiten te definiëren die specifiek zijn voor Microsoft Access-connector.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor Microsoft Access gekoppelde service:

Eigenschap Beschrijving Vereist
type De eigenschap type moet worden ingesteld op: MicrosoftAccess Ja
connectionString De ODBC-connection string zonder het referentiegedeelte. U kunt de verbindingsreeks opgeven of de systeem-DSN (gegevensbronnaam) gebruiken die u hebt ingesteld op de Integration Runtime-computer (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 connection string halen. Zie Referenties opslaan in Azure Key Vault voor meer details.
Ja
authenticatietype Type verificatie dat wordt gebruikt om verbinding te maken met het Microsoft Access gegevensarchief.
Toegestane waarden zijn: Basis en Anoniem.
Ja
gebruikersnaam Geef de gebruikersnaam op als u basisverificatie gebruikt. Nee
wachtwoord 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 verwijzing van een geheim dat is opgeslagen in Azure Key Vault. Nee
inloggegevens Het deel met de toegangsinformatie van de connection string gespecificeerd in een stuurprogrammaspecifiek eigenschaps-waardeformaat. Markeer dit veld als securestring. Nee
connectVia De Integration Runtime dat moet worden gebruikt om verbinding te maken met de gegevensopslag. Een zelf-hostende Integration Runtime is vereist, zoals vermeld in Prerequisites. Ja

Voorbeeld:

{
    "name": "MicrosoftAccessLinkedService",
    "properties": {
        "type": "MicrosoftAccess",
        "typeProperties": {
            "connectionString": "Driver={Microsoft Access Driver (*.mdb, *.accdb)};Dbq=<path to your DB file e.g. C:\\mydatabase.accdb>;",
            "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 Microsoft Access gegevensset.

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

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

Voorbeeld

{
    "name": "MicrosoftAccessDataset",
    "properties": {
        "type": "MicrosoftAccessTable",
        "linkedServiceName": {
            "referenceName": "<Microsoft Access linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties": {
            "tableName": "<table name>"
        }
    }
}

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 Microsoft Access bron.

Microsoft Access als bron

Als u gegevens uit Microsoft Access wilt kopiëren, worden de volgende eigenschappen ondersteund in de sectie kopieeractiviteit source:

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

Voorbeeld:

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

Microsoft Access als ontvangend eindpunt

Als u gegevens naar Microsoft Access wilt kopiëren, worden de volgende eigenschappen ondersteund in de sectie kopieeractiviteit sink:

Eigenschap Beschrijving Vereist
type De typeeigenschap van de sink van de kopieeractiviteit moet worden ingesteld op: MicrosoftAccessSink Ja
writeBatchTimeout Wachttijd totdat de batchinvoegbewerking voltooid is, 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
 maximale gelijktijdige verbindingen 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": "CopyToMicrosoftAccess",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<Microsoft Access output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "MicrosoftAccessSink"
            }
        }
    }
]

Eigenschappen van opzoekactiviteit

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

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