Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
APPLICABILE A:
Azure Data Factory
Azure Synapse Analytics
Suggerimento
Data Factory in Microsoft Fabric è la nuova generazione di Azure Data Factory, con un'architettura più semplice, un'intelligenza artificiale predefinita e nuove funzionalità. Se non si ha familiarità con l'integrazione dei dati, iniziare con Fabric Data Factory. I carichi di lavoro di Azure Data Factory esistenti possono eseguire l'aggiornamento a Fabric per accedere a nuove funzionalità tra data science, analisi in tempo reale e creazione di report.
Questo articolo illustra come usare l'attività di copia nelle pipeline di Azure Data Factory e Synapse Analytics per copiare dati da un archivio dati Microsoft Access. Si basa sull'articolo di panoramica dell'attività di copia che presenta una panoramica generale sull'attività di copia.
Funzionalità supportate
Questo connettore Microsoft Access è supportato per le funzionalità seguenti:
| Funzionalità supportate | IR |
|---|---|
| Attività di copia (sorgente/destinazione) | 2 |
| Attività di Ricerca | 2 |
(1) Runtime di integrazione Azure (2) Runtime di integrazione self-hosted
Per un elenco degli archivi dati supportati come origini/sink dall'attività di copia, vedere la tabella relativa agli archivi dati supportati.
Prerequisiti
Per usare questo connettore Microsoft Access, è necessario:
- Configurare un Integration Runtime autogestito. Per informazioni dettagliate, vedere l'articolo Self-hosted Integration Runtime.
- Installare il driver ODBC Microsoft Access per l'archivio dati nel computer Integration Runtime.
Nota
Questo connettore funziona con Microsoft Access 2016 versione del driver ODBC. La versione del driver consigliata è la 16.00.5378.1000 o versione successiva.
Iniziare
Per eseguire l'attività di copia con una pipeline, è possibile usare uno degli strumenti o degli SDK seguenti:
- Strumento di copia dati
- portale Azure
- .NET SDK
- Python SDK
- Azure PowerShell
- API REST
- modello Azure Resource Manager
Creare un servizio collegato per Microsoft Access usando l'interfaccia utente
Usare la procedura seguente per creare un servizio collegato per Microsoft Access nell'interfaccia utente del portale di Azure.
Passare alla scheda Gestisci nell'area di lavoro Azure Data Factory o Synapse e selezionare Servizi collegati, quindi fare clic su Nuovo:
Cercare Access e selezionare il connettore Microsoft Access.
Configurare i dettagli del servizio, testare la connessione e creare il nuovo servizio collegato.
Dettagli di configurazione del connettore
Le sezioni seguenti forniscono informazioni dettagliate sulle proprietà usate per definire entità di Data Factory specifiche per Microsoft Access connettore.
Proprietà del servizio collegato
Per Microsoft Access servizio collegato sono supportate le proprietà seguenti:
| Proprietà | Descrizione | Richiesto |
|---|---|---|
| tipo | La proprietà type deve essere impostata su: MicrosoftAccess | Sì |
| stringa di connessione | ODBC stringa di connessione escludendo la parte relativa alle credenziali. È possibile specificare il stringa di connessione o usare il DSN di sistema (nome origine dati) configurato nel computer Integration Runtime (è comunque necessario specificare la parte delle credenziali nel servizio collegato di conseguenza). È anche possibile inserire una password in Azure Key Vault ed estrarre la configurazione password dalla stringa di connessione. Per ulteriori dettagli, consultare Archiviare le credenziali in Azure Key Vault. |
Sì |
| tipo di autenticazione | Tipo di autenticazione usato per connettersi all'archivio dati Microsoft Access. I valori consentiti sono Base e Anonimo. |
Sì |
| userName | Specificare il nome utente se si usa l'autenticazione di base. | No |
| password | Specificare la password per l'account utente specificato per userName. Contrassegnare questo campo come SecureString per archiviarlo in modo sicuro o referenziare un segreto archiviato in Azure Key Vault. | No |
| credenziali | Parte delle credenziali di accesso del stringa di connessione specificata nel formato del valore della proprietà specifico del driver. Contrassegnare questo campo come SecureString. | No |
| connectVia | Integration Runtime da usare per connettersi all'archivio dati. Un Self-hosted Integration Runtime è necessario come indicato in Prerequisiti. | Sì |
Esempio:
{
"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"
}
}
}
Proprietà del set di dati
Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione di set di dati, vedere l'articolo sui set di dati. In questa sezione viene fornito un elenco delle proprietà supportate dal set di dati di Microsoft Access.
Per copiare dati da Microsoft Access, sono supportate le proprietà seguenti:
| Proprietà | Descrizione | Richiesto |
|---|---|---|
| tipo | La proprietà type del set di dati deve essere impostata su: MicrosoftAccessTable | Sì |
| tableName | Nome della tabella nella Microsoft Access. | No per l'origine (se nell'origine dell'attività è specificato "query"); Sì per il lavello |
Esempio
{
"name": "MicrosoftAccessDataset",
"properties": {
"type": "MicrosoftAccessTable",
"linkedServiceName": {
"referenceName": "<Microsoft Access linked service name>",
"type": "LinkedServiceReference"
},
"typeProperties": {
"tableName": "<table name>"
}
}
}
proprietà dell'attività di copia
Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere l'articolo sulle pipeline. In questa sezione è fornito un elenco delle proprietà supportate da Microsoft Access origine.
Microsoft Access come origine
Per copiare dati da Microsoft Access, le proprietà seguenti sono supportate nella sezione source dell'attività di copia:
| Proprietà | Descrizione | Richiesto |
|---|---|---|
| tipo | La proprietà type dell'origine dell'attività di copia deve essere impostata su MicrosoftAccessSource. | Sì |
| interrogazione | Usare la query personalizzata per leggere i dati. Ad esempio: "SELECT * FROM MyTable". |
No (se nel set di dati è specificato "tableName") |
Esempio:
"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 come destinazione
Per copiare i dati in Microsoft Access, le proprietà seguenti sono supportate nella sezione sink:
| Proprietà | Descrizione | Richiesto |
|---|---|---|
| tipo | La proprietà type del sink dell'attività Copy deve essere impostata su: MicrosoftAccessSink | Sì |
| writeBatchTimeout | Tempo di attesa per l'operazione di inserimento batch da completare prima del timeout. I valori consentiti sono: intervallo di tempo. Ad esempio: "00:30:00" (30 minuti). |
No |
| writeBatchSize | Inserisce dati nella tabella SQL quando la dimensione del buffer raggiunge writeBatchSize. I valori consentiti sono integer, ovvero il numero di righe. |
No (l'impostazione predefinita è 0 - rilevamento automatico) |
| preCopyScript | Specificare una query SQL per l'attività di copia da eseguire prima di scrivere i dati nell'archivio dati in ogni esecuzione. È possibile usare questa proprietà per pulire i dati precaricati. | No |
| maxConcurrentConnections | Limite massimo di connessioni simultanee all'archivio dati stabilite durante l'esecuzione dell'attività. Specificare un valore solo se si vogliono limitare le connessioni simultanee. | No |
Esempio:
"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"
}
}
}
]
Proprietà dell'attività Lookup
Per conoscere i dettagli delle proprietà, vedere Attività di ricerca.
Contenuto correlato
Per un elenco degli archivi dati supportati come origini e sink dall'attività Copy, consultare la sezione Archivi dati supportati.