Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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:
- Datenkopier-Werkzeug
- Azure Portal
- .NET SDK
- Python SDK
- Azure PowerShell
- REST-API
- Azure Resource Manager Vorlage
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.
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":
Suchen Sie nach Access, und wählen Sie den Microsoft Access Connector aus.
Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.
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.
Zugehöriger Inhalt
Eine Liste der Datenspeicher, die als Quellen und Senken für die Kopieraktivität unterstützt werden, finden Sie in unterstützte Datenspeicher.