適用於:
Azure Data Factory
Azure Synapse Analytics
提示
Data Factory in Microsoft Fabric 是下一代的 Azure Data Factory,擁有更簡單的架構、內建 AI 及新功能。 如果你是資料整合新手,建議先從 Fabric Data Factory 開始。 現有的 ADF 工作負載可升級至 Fabric,以存取資料科學、即時分析與報告等新能力。
本文說明如何利用 Azure Data Factory 中的複製活動與 Synapse Analytics 管線,從 Microsoft Access 資料庫複製資料。 這是基於複製活動概觀一篇文章,該文章介紹複製活動的一般概況。
支援的功能
此 Microsoft Access 連接器支援以下功能:
| 支援的功能 | IR |
|---|---|
| 複製活動 (來源/接收) | ② |
| 查找活動 | ② |
(1) Azure 整合執行時 (2) 自架整合執行時
如需複製活動所支援作為來源/接收器的資料存放區清單,請參閱支援的資料存放區表格。
必要條件
要使用此 Microsoft Access 連接器,您需要:
- 設定自架設 Integration Runtime 環境。 詳情請參見 Self-hosted Integration Runtime 條目。
- 在 Integration Runtime 機器上安裝 Microsoft Access ODBC 驅動程式。
注意
此連接器可搭配 Microsoft Access 2016 版本的 ODBC 驅動程式使用。 建議的驅動程式版本為 16.00.5378.1000 或更新版本。
開始使用
若要使用管線執行複製活動,您可以使用下列其中一個工具或 SDK:
使用 UI 建立與 Microsoft Access 連結的服務
請依照以下步驟在 Azure 入口網站介面中建立與 Microsoft Access 的連結服務。
請瀏覽 Azure Data Factory 或 Synapse 工作區的管理標籤,選擇連結服務,然後點選新建:
搜尋 Access 並選擇 Microsoft Access 連接器。
設定服務詳細資料,測試連線,然後建立新的連結服務。
連接器設定詳細資料
以下章節將詳細說明用於定義 Microsoft Access 連接器專屬資料工廠實體的屬性。
連結服務屬性
以下屬性支援 Microsoft Access 連結服務:
| 屬性 | 描述 | 必要 |
|---|---|---|
| 型別 | type 屬性必須設定為:Microsoft Access | Yes |
| connectionString | ODBC 連線字串中不含憑證部分。 你可以指定連接字串,或使用你在 Integration Runtime 機器上設定的系統 DSN(資料來源名稱)(你仍然需要在連結服務中指定認證資料部分)。 你也可以在Azure Key Vault設定密碼,然後從connection string中移除 password設定。 詳情請參考在 Azure Key Vault 中存放憑據。 |
Yes |
| 認證類型 | 用於連接 Microsoft Access 資料儲存庫的認證類型。 允許的值為:Basic (基本) 和 Anonymous (匿名)。 |
Yes |
| userName | 如果您要使用 Basic 驗證,請指定使用者名稱。 | No |
| 密碼 | 指定您為 userName 指定之使用者帳戶的密碼。 將此欄位標記為 SecureString 以安全儲存,或參考儲存在 Azure Key Vault 的機密。 | No |
| 認證 | connection string 中的存取憑證部分以驅動程式專屬屬性值格式指定。 請將此欄位標示為 SecureString。 | No |
| connectVia | Integration Runtime 用於連接資料儲存。 如Prerequisites中所述,需要自行架設的整合執行階段。 | Yes |
範例:
{
"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"
}
}
}
資料集屬性
如需可用來定義資料集的區段和屬性完整清單,請參閱資料集一文。 本節提供 Microsoft Access 資料集所支援的屬性清單。
要從 Microsoft Access 複製資料,支援以下屬性:
| 屬性 | 描述 | 必要 |
|---|---|---|
| 型別 | 資料集的類型屬性必須設定為:MicrosoftAccessTable | Yes |
| 資料表名稱 | Microsoft Access 中資料表的名稱。 | 否 (若在活動來源中指定「query」); 是,用於接收器 |
範例
{
"name": "MicrosoftAccessDataset",
"properties": {
"type": "MicrosoftAccessTable",
"linkedServiceName": {
"referenceName": "<Microsoft Access linked service name>",
"type": "LinkedServiceReference"
},
"typeProperties": {
"tableName": "<table name>"
}
}
}
複製活動屬性
如需可用來定義活動的區段和屬性完整清單,請參閱管線一文。 本節提供 Microsoft Access 原始碼所支援的屬性清單。
Microsoft Access 作為來源
若要從Microsoft Access複製資料,複製活動
| 屬性 | 描述 | 必要 |
|---|---|---|
| 型別 | 複製活動來源的 type 屬性必須設定為 MicrosoftAccessSource | Yes |
| 查詢 | 使用自訂查詢來讀取資料。 例如: "SELECT * FROM MyTable" 。 |
否 (如果已指定資料集中 "tableName") |
範例:
"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 作為接收端
若要將資料複製到 Microsoft Access,複製活動的 sink 區段支援以下屬性:
| 屬性 | 描述 | 必要 |
|---|---|---|
| 型別 | 複製活動接收器的 type 屬性必須設定為 MicrosoftAccessSink | Yes |
| writeBatchTimeout | 等待批次插入作業完成後再逾時。 允許的值為:時間範圍。 範例:“00:30:00” (30 分鐘)。 |
No |
| writeBatchSize | 當緩衝區大小達到 writeBatchSize 時,將資料插入 SQL 資料表中 允許的值為:整數 (資料列數目)。 |
No (預設值為 0 - 自動偵測) |
| preCopyScript | 指定一個供「複製活動」在每次執行時將資料寫入到資料存放區前執行的 SQL 查詢。 您可以使用此屬性來清除預先載入的資料。 | No |
| 最大並發連線數 | 在活動執行期間,建立到資料存放區的並行連線上限。僅在想要限制並行連線時,才需要指定值。 | 否 |
範例:
"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"
}
}
}
]
查閱活動屬性
若要了解屬性的詳細資料,請參閱查詢活動。
相關內容
如需複製活動支援作為來源和接收器的資料存放區清單,請參閱支援的資料存放區。