Freigeben über


Kopieren von Daten aus und in Microsoft Access mithilfe von Azure Data Factory oder Synapse Analytics

Gilt für: Azure Data Factory Azure Synapse Analytics

Tipp

Data Factory in Microsoft Fabric ist die nächste Generation von Azure Data Factory mit einer einfacheren Architektur, integrierter KI und neuen Features. Wenn Sie mit der Datenintegration noch nicht vertraut sind, beginnen Sie mit Fabric Data Factory. Vorhandene ADF-Workloads können auf Fabric aktualisiert werden, um auf neue Funktionen in der Datenwissenschaft, Echtzeitanalysen und Berichterstellung zuzugreifen.

In diesem Artikel wird beschrieben, wie Sie die Kopieraktivität in Azure Data Factory- und Synapse Analytics-Pipelines verwenden, um Daten aus einem Microsoft Access Datenspeicher zu kopieren. Er baut auf dem Artikel zur Übersicht über die Kopieraktivität auf, der eine allgemeine Übersicht über die Kopieraktivität enthält.

Unterstützte Funktionen

Dieser Microsoft Access Connector wird für die folgenden Funktionen unterstützt:

Unterstützte Funktionen Infrarot
Copy-Aktivität (Quelle/Senke)
Lookup-Aktivität

(1) Azure Integrationslaufzeit (2) Selbst gehostete Integrationslaufzeit

Eine Liste der Datenspeicher, die als Quellen oder Senken für die Kopieraktivität unterstützt werden, finden Sie in der Tabelle Unterstützte Datenspeicher.

Voraussetzungen

Um diesen Microsoft Access Connector zu verwenden, müssen Sie:

  • Richten Sie eine selbst gehostete Integration Runtime ein. Ausführliche Informationen finden Sie im Artikel Self-hosted Integration Runtime.
  • Installieren Sie den Microsoft Access ODBC-Treiber für den Datenspeicher auf dem Integration Runtime Computer.

Hinweis

Dieser Connector funktioniert mit microsoft Access 2016 Version des ODBC-Treibers. Die empfohlene Treiberversion ist 16.00.5378.1000 oder höher.

Erste Schritte

Zum Ausführen der Kopieraktivität mit einer Pipeline können Sie eines der folgenden Tools oder SDKs verwenden:

Erstellen eines verknüpften Diensts zum Microsoft Access mithilfe der Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um im Azure-Portal einen verknüpften Dienst zu Microsoft Access zu erstellen.

  1. Navigieren Sie in Ihrem Azure Data Factory- oder Synapse-Arbeitsbereich zur Registerkarte "Verwalten", und wählen Sie "Verknüpfte Dienste" aus, und klicken Sie dann auf "Neu":

  2. Suchen Sie nach Access, und wählen Sie den Microsoft Access Connector aus.

    Wählen Sie den Microsoft Access Connector aus.

  3. Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.

    Konfigurieren Sie einen verknüpften Dienst zu Microsoft Access.

Details zur Connector-Konfiguration

Die folgenden Abschnitte enthalten Details zu Eigenschaften, die zum Definieren von Data Factory-Entitäten verwendet werden, die für Microsoft Access Connector spezifisch sind.

Eigenschaften des verknüpften Diensts

Die folgenden Eigenschaften werden für Microsoft Access verknüpften Dienst unterstützt:

Eigenschaft Beschreibung Erforderlich
Typ Die type-Eigenschaft muss auf Folgendes festgelegt werden: MicrosoftAccess Ja
connectionString Die ODBC-Verbindungszeichenfolge mit Ausnahme der Anmeldedaten. Sie können die Verbindungszeichenfolge angeben oder den System-DSN (Data Source Name) verwenden, den Sie auf dem Computer mit der Integration Runtime eingerichtet haben. (Sie müssen nach wie vor den Teil mit den Anmeldeinformationen im verknüpften Dienst entsprechend angeben.)
Sie können auch ein Kennwort in Azure Key Vault einfügen und die konfiguration password aus dem Verbindungszeichenfolge ziehen. Weitere Informationen finden Sie unter Store-Anmeldeinformationen in Azure Key Vault.
Ja
Authentifizierungstyp Typ der Authentifizierung, die zum Herstellen einer Verbindung mit dem Microsoft Access Datenspeicher verwendet wird.
Zulässige Werte sind: Standard und Anonym.
Ja
userName Geben Sie den Benutzernamen an, wenn Sie die Standardauthentifizierung (Basic) verwenden. Nein
Passwort Geben Sie das Kennwort für das Benutzerkonto an, das Sie für „userName“ angegeben haben. Markieren Sie dieses Feld als SecureString, um es sicher zu speichern, oder verweisen Sie auf ein in Azure Key Vault gespeichertes Geheimnis. Nein
Berechtigungsnachweis Der zum Zugriff bestimmte Teil der Anmeldeinformationen in der Verbindungszeichenfolge. Er wird in einem treiberspezifischen Format in Eigenschaft und Wert angegeben. Legen Sie für dieses Feld „SecureString“ fest. Nein
connectVia Die Integration Runtime wird verwendet, um eine Verbindung mit dem Datenspeicher herzustellen. Eine selbst gehostete Integration Runtime ist erforderlich, wie in Prerequisites erwähnt. Ja

Beispiel:

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

Dataset-Eigenschaften

Eine vollständige Liste mit den Abschnitten und Eigenschaften, die zum Definieren von Datasets zur Verfügung stehen, finden Sie im Artikel zu Datasets. Dieser Abschnitt enthält eine Liste der Eigenschaften, die von Microsoft Access Datasets unterstützt werden.

Zum Kopieren von Daten aus Microsoft Access werden die folgenden Eigenschaften unterstützt:

Eigenschaft Beschreibung Erforderlich
Typ Die type-Eigenschaft des Datasets muss auf folgenden Wert festgelegt werden: MicrosoftAccessTable Ja
Tabellenname Name der Tabelle im Microsoft Access. Nein für Quelle (wenn „query“ in der Aktivitätsquelle angegeben ist);
Ja zur Senke

Beispiel

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

Eigenschaften der Kopieraktivität

Eine vollständige Liste mit den Abschnitten und Eigenschaften zum Definieren von Aktivitäten finden Sie im Artikel Pipelines. Dieser Abschnitt enthält eine Liste von Eigenschaften, die von Microsoft Access Quelle unterstützt werden.

Microsoft Access als Quelle

Zum Kopieren von Daten aus Microsoft Access werden die folgenden Eigenschaften im Abschnitt source unterstützt:

Eigenschaft Beschreibung Erforderlich
Typ Die type-Eigenschaft der Quelle der Kopieraktivität muss auf Folgendes festgelegt werden: MicrosoftAccessSource Ja
Abfrage Verwendet die benutzerdefinierte Abfrage zum Lesen von Daten. Beispiel: "SELECT * FROM MyTable". Nein (wenn „tableName“ im Dataset angegeben ist)

Beispiel:

"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 Senke

Beim Kopieren von Daten in Microsoft Access werden die folgenden Eigenschaften im Abschnitt source der Kopieraktivität unterstützt:

Eigenschaft Beschreibung Erforderlich
Typ Die type-Eigenschaft der Senke der Kopieraktivität muss auf Folgendes festgelegt sein: MicrosoftAccessSink Ja
writeBatchTimeout Die Wartezeit für den Abschluss der Batcheinfügung, bis das Timeout wirksam wird.
Zulässige Werte: Zeitraum Beispiel: „00:30:00“ (30 Minuten).
Nein
writeBatchSize Fügt Daten in die SQL-Tabelle ein, wenn die Puffergröße "writeBatchSize" erreicht.
Zulässige Werte: Ganze Zahlen (Anzahl der Zeilen).
Nein (Standard ist 0 – automatisch erkannt)
preCopyScript Geben Sie eine auszuführende SQL-Abfrage für die Kopieraktivität an, ehe Sie bei der jeder Ausführung Daten in Datenspeicher schreiben. Sie können diese Eigenschaft nutzen, um die vorab geladenen Daten zu bereinigen. Nein
 maxConcurrentConnections (maximale gleichzeitige Verbindungen) Die maximale Anzahl gleichzeitiger Verbindungen, die während der Aktivitätsausführung mit dem Datenspeicher hergestellt werden. Geben Sie nur dann einen Wert an, wenn Sie die Anzahl gleichzeitiger Verbindungen begrenzen möchten.  Nein

Beispiel:

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

Eigenschaften der Lookup-Aktivität

Ausführliche Informationen zu den Eigenschaften finden Sie unter Lookup-Aktivität.

Eine Liste der Datenspeicher, die als Quellen und Senken für die Kopieraktivität unterstützt werden, finden Sie in unterstützte Datenspeicher.