Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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:
- Tool Gegevens kopiëren
- Azure-portal
- .NET SDK
- Python SDK
- Azure PowerShell
- REST API
- Azure Resource Manager sjabloon
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.
Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:
Zoek naar Access en selecteer de Microsoft Access-connector.
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 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.
Gerelateerde inhoud
Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.