Azure Data Factory または Synapse Analytics を使用して Microsoft Access をコピー元またはコピー先としてデータをコピーする

[アーティクル]
04/18/2024

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータサイエンス、リアルタイム分析、ビジネスインテリジェンス、レポートまで、あらゆるものをカバーしています。無料で新たに試用を開始する方法については、こちらをご覧ください。

この記事では、Azure Data Factory および Synapse Analytics パイプラインでコピーアクティビティを使用して、Microsoft Access データストアからデータをコピーする方法について説明します。この記事は、コピーアクティビティの概要を示しているコピーアクティビティの概要に関する記事に基づいています。

サポートされる機能

この Microsoft Access コネクタは、以下の機能でサポートされています。

サポートされる機能	IR
Copy アクティビティ (ソース/シンク)	②
Lookup アクティビティ	②

① Azure 統合ランタイム ② セルフホステッド統合ランタイム

コピーアクティビティによってソースまたはシンクとしてサポートされているデータストアの一覧については、サポートされているデータストアに関する記事の表をご覧ください。

前提条件

この Microsoft Access コネクタを使用するには、次のことを行う必要があります。

セルフホステッド統合ランタイムをセットアップする。詳細については、セルフホステッド統合ランタイムに関する記事をご覧ください。
データストア用の Microsoft Access ODBC ドライバーを統合ランタイムマシンにインストールする。

Note

このコネクタは、Microsoft Access 2016 バージョンの ODBC ドライバーで動作します。推奨されるドライバーのバージョンは 16.00.5378.1000 以降です。

作業の開始

パイプラインでコピーアクティビティを実行するには、次のいずれかのツールまたは SDK を使用します。

UI を使用して Microsoft Access のリンクサービスを作成する

次の手順を使用して、Azure portal UI で Microsoft Access のリンクサービスを作成します。

Azure Data Factory または Synapse ワークスペースの [管理] タブに移動し、[リンクされたサービス] を選択して、[新規] をクリックします。
- Azure Data Factory
- Azure Synapse
Access を検索し、Microsoft Access コネクタを選択します。
サービスの詳細を構成し、接続をテストして、新しいリンクサービスを作成します。

コネクタの構成の詳細

次のセクションでは、Microsoft Access コネクタに固有の Data Factory エンティティを定義するために使用されるプロパティについて詳しく説明します。

リンクされたサービスのプロパティ

Microsoft Access のリンクされたサービスでは、次のプロパティがサポートされます。

プロパティ	内容	必須
type	type プロパティは、次のように設定する必要があります:MicrosoftAccess	はい
connectionString	資格情報部分を除外した ODBC 接続文字列。接続文字列を指定するか、Integration Runtime マシンに設定したシステム DSN (データソース名) を使用することができます (その場合も、リンクされたサービスの資格情報部分をそれに応じて指定する必要があります)。パスワードを Azure Key Vault に格納して、接続文字列から `password` 構成をプルすることもできます。詳細については、「Azure Key Vault への資格情報の格納」を参照してください。	はい
authenticationType	Microsoft Access データストアへの接続に使用される認証の種類です。使用できる値は、以下のとおりです。Basic と Anonymous。	はい
userName	基本認証を使用している場合は、ユーザー名を指定します。	いいえ
password	userName に指定したユーザーアカウントのパスワードを指定します。このフィールドを SecureString とマークして安全に保存するか、Azure Key Vault に保存されているシークレットを参照します。	いいえ
資格情報 (credential)	ドライバー固有のプロパティ値の形式で指定された接続文字列のアクセス資格情報の部分。このフィールドを SecureString とマークします。	いいえ
connectVia	データストアに接続するために使用される統合ランタイム。「前提条件」に記されているように、セルフホステッド統合ランタイムが必要です。	はい

例:

{
    "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	データセットの type プロパティは、次のように設定する必要があります:MicrosoftAccessTable	はい
tableName	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 からデータをコピーするために、コピーアクティビティの source セクションでは次のプロパティがサポートされています。

プロパティ	内容	必須
type	コピーアクティビティのソースの type プロパティは、次のように設定する必要があります:MicrosoftAccessSource	はい
query	カスタムクエリを使用してデータを読み取ります。 (例: `"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	コピーアクティビティのシンクの 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 アクティビティでソースおよびシンクとしてサポートされるデータストアの一覧については、サポートされるデータストアに関するセクションを参照してください。