適用対象:
Azure Data Factory
Azure Synapse Analytics
ヒント
Data Factory in Microsoft Fabric は、よりシンプルなアーキテクチャ、組み込みの AI、および新機能を備えた次世代のAzure Data Factoryです。 データ統合を初めて使用する場合は、Fabric Data Factory から始めます。 既存の ADF ワークロードをFabricにアップグレードして、データ サイエンス、リアルタイム分析、レポートの新機能にアクセスできます。
この記事では、Azure Data Factory パイプラインと Synapse Analytics パイプラインのコピー アクティビティを使用して、Microsoft Access データ ストアからデータをコピーする方法について説明します。 この記事は、コピー アクティビティの概要を示しているコピー アクティビティの概要に関する記事に基づいています。
サポートされる機能
このMicrosoft Access コネクタは、次の機能でサポートされています。
| サポートされる機能 | IR |
|---|---|
| Copy アクティビティ (ソース/シンク) | ② |
| ルックアップ アクティビティ | ② |
(1) Azure統合ランタイム (2) セルフホステッド統合ランタイム
コピー アクティビティによってソースまたはシンクとしてサポートされているデータ ストアの一覧については、サポートされているデータ ストアに関する記事の表をご覧ください。
前提条件
このMicrosoft Access コネクタを使用するには、次の操作を行う必要があります。
- セルフホスト型インテグレーションランタイムを設定します。 詳細については、セルフホステッド Integration Runtimeに関する記事を参照してください。
- Integration Runtime コンピューターにデータ ストア用のMicrosoft Access ODBC ドライバーをインストールします。
注意
このコネクタは、Microsoft Access 2016 バージョンの ODBC ドライバーで動作します。 推奨されるドライバーのバージョンは 16.00.5378.1000 以降です。
作業の開始
パイプラインでコピー アクティビティを実行するには、次のいずれかのツールまたは SDK を使用できます。
- データのコピー ツール
- Azure portal
- .NET SDK
- Python SDK
- Azure PowerShell
- REST API
- Azure Resource Manager テンプレート
UI を使用してMicrosoft Accessするリンクされたサービスを作成する
Azure ポータル UI でMicrosoft Accessするリンクされたサービスを作成するには、次の手順に従います。
Azure Data Factoryまたは Synapse ワークスペースの [管理] タブを参照し、[リンクされたサービス] を選択し、[新規] をクリックします。
Access を検索し、Microsoft Access コネクタを選択します。
サービスの詳細を構成し、接続をテストして、新しいリンク サービスを作成します。
コネクタの構成の詳細
次のセクションでは、Microsoft Access コネクタに固有の Data Factory エンティティの定義に使用されるプロパティについて詳しく説明します。
リンクされたサービスのプロパティ
Microsoft Access リンク サービスでは、次のプロパティがサポートされています。
| プロパティ | 内容 | 必須 |
|---|---|---|
| 型 | type プロパティは、次のように設定する必要があります:MicrosoftAccess | はい |
| 接続文字列 | 資格情報部分を除いたODBC接続文字列。 接続文字列を指定することも、Integration Runtime マシンで設定したシステム DSN (データ ソース名) を使用することもできます (それに応じて、リンクされたサービスの資格情報部分を指定する必要があります)。 Azure Key Vaultにパスワードを入力し、接続文字列から password 構成をプルすることもできます。 詳細については、「store credentials in Azure Key Vaultを参照してください。 |
はい |
| 認証タイプ | Microsoft Access データ ストアへの接続に使用される認証の種類。 使用できる値は、以下のとおりです。Basic と Anonymous。 |
はい |
| userName | 基本認証を使用している場合は、ユーザー名を指定します。 | いいえ |
| パスワード | userName に指定したユーザー アカウントのパスワードを指定します。 このフィールドを SecureString としてマークして安全に格納するか、 |
いいえ |
| 資格情報 | ドライバー固有のプロパティ値の形式で指定された接続文字列のアクセス資格情報の部分。 このフィールドを SecureString とマークします。 | いいえ |
| connectVia | データ ストアへの接続に使用するIntegration Runtime。 Prerequisitesで説明されているように、セルフホステッド Integration Runtime が必要です。 | はい |
例:
{
"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からデータをコピーするには、次のプロパティがサポートされています。
| プロパティ | 内容 | 必須 |
|---|---|---|
| 型 | データセットの type プロパティは、次のように設定する必要があります:MicrosoftAccessTable | はい |
| tableName | Microsoft Access内のテーブルの名前。 | ソースの場合はいいえ (アクティビティ ソースの "query" が指定されている場合)、 シンクの場合ははい |
例
{
"name": "MicrosoftAccessDataset",
"properties": {
"type": "MicrosoftAccessTable",
"linkedServiceName": {
"referenceName": "<Microsoft Access linked service name>",
"type": "LinkedServiceReference"
},
"typeProperties": {
"tableName": "<table name>"
}
}
}
Copy アクティビティ のプロパティ
アクティビティの定義に利用できるセクションとプロパティの完全な一覧については、パイプラインに関する記事を参照してください。 このセクションでは、Microsoft Access ソースでサポートされるプロパティの一覧を示します。
ソースとしてMicrosoft Accessを使用する
Microsoft Accessからデータをコピーするには、コピー アクティビティ source セクションで次のプロパティがサポートされています。
| プロパティ | 内容 | 必須 |
|---|---|---|
| 型 | コピー アクティビティのソースの type プロパティは、次のように設定する必要があります:MicrosoftAccessSource | はい |
| クエリ | カスタム クエリを使用してデータを読み取ります。 (例: "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 | はい |
| writeBatchTimeout | タイムアウトする前に一括挿入操作の完了を待つ時間です。 使用可能な値: 期間。 例:"00:30:00" (30 分)。 |
いいえ |
| writeBatchSize | バッファー サイズが writeBatchSize に達したときに SQL テーブルにデータを挿入します。 使用可能な値: 整数 (行数)。 |
いいえ (既定値は 0 - 自動検出) |
| preCopyScript | コピー アクティビティの毎回の実行で、データをデータ ストアに書き込む前に実行する SQL クエリを指定します。 このプロパティを使用して、事前に読み込まれたデータをクリーンアップできます。 | いいえ |
| 同時接続数の最大数 (maxConcurrentConnections) | アクティビティの実行中にデータ ストアに対して確立されたコンカレント接続の上限です。コンカレント接続数を制限する場合にのみ、値を指定します。 | なし |
例:
"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"
}
}
}
]
Lookup アクティビティのプロパティ
プロパティの詳細については、Lookup アクティビティに関するページを参照してください。
関連するコンテンツ
Copy アクティビティでソースおよびシンクとしてサポートされるデータ ストアの一覧については、サポートされるデータ ストアに関するセクションを参照してください。