Azure Data Factoryを使用して Couchbase からデータをコピーする (プレビュー)

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

Data Factory in Microsoft Fabric は、よりシンプルなアーキテクチャ、組み込みの AI、および新機能を備えた次世代のAzure Data Factoryです。データ統合を初めて使用する場合は、Fabric Data Factory から始めます。既存の ADF ワークロードをFabricにアップグレードして、データサイエンス、リアルタイム分析、レポートの新機能にアクセスできます。

Fabric無料試用版を開始します。
Azure Data Factory から Microsoft Fabric の Data Factory へのアップグレード

重要

このコネクタは、サポート終了段階にあります。ドライバーをインストールして ODBC コネクタに移行することをお勧めします。

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

サポートされる機能

この Couchbase コネクタは、次の機能をサポートしています。

サポートされる機能	IR
コピーアクティビティ (ソース/-)	(1) (2)
Lookup アクティビティ	(1) (2)

(1) Azure統合ランタイム (2) セルフホステッド統合ランタイム

ソースおよびシンクとしてサポートされているデータストアの一覧については、「サポートされているデータストア」の表を参照してください。

このサービスでは接続を有効にする組み込みのドライバーが提供されるので、このコネクタを使用してドライバーを手動でインストールする必要はありません。

コネクタは、6.0 よりも後の Couchbase バージョンをサポートしています。

前提条件

データストアがオンプレミスネットワーク、Azure仮想ネットワーク、または Amazon Virtual Private Cloud 内にある場合は、自身がホストする統合ランタイムを構成して接続する必要があります。

データストアがマネージドクラウドデータサービスの場合は、Azure Integration Runtimeを使用できます。アクセスがファイアウォール規則で承認されている IP に制限されている場合は、許可リストに Azure Integration Runtime IP を追加できます。

Azure Data Factoryの管理された仮想ネットワーク統合ランタイム機能を使用して、セルフホステッド統合ランタイムをインストールして構成することなく、オンプレミスネットワークにアクセスすることもできます。

Data Factory によってサポートされるネットワークセキュリティメカニズムやオプションの詳細については、「データアクセス戦略」を参照してください。

作業の開始

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

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

次の手順を使用して、Azure ポータル UI で Couchbase へのリンクされたサービスを作成します。

Azure Data Factoryまたは Synapse ワークスペースの [管理] タブを参照し、[リンクされたサービス] を選択し、[新規] をクリックします。
- Azure Data Factory
- Azure Synapse
Azure Data Factory UI を使用した新しいリンクサービスの作成のスクリーンショット
Couchbase を検索し、Couchbase コネクタを選択します。
サービスの詳細を構成し、接続をテストして、新しいリンクサービスを作成します。

コネクタの構成の詳細

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

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

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

プロパティ	内容	必須
型	type プロパティを Couchbase に設定する必要があります	はい
接続文字列	Couchbase に接続するための ODBC 接続文字列。 Azure Key Vaultに資格情報文字列を配置し、接続文字列から `credString` 構成をプルすることもできます。詳細については、次のサンプルと Store credentials in Azure Key Vault の記事を参照してください。	はい
connectVia	データストアへの接続に使用するIntegration Runtime。詳細については、「前提条件」セクションを参照してください。指定しない場合は、既定のAzure Integration Runtimeが使用されます。	いいえ

例:

{
    "name": "CouchbaseLinkedService",
    "properties": {
        "type": "Couchbase",
        "typeProperties": {
            "connectionString": "Server=<server>; Port=<port>;AuthMech=1;CredString=[{\"user\": \"JSmith\", \"pass\":\"access123\"}, {\"user\": \"Admin\", \"pass\":\"simba123\"}];"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Example: 資格情報文字列を Azure Key Vault

{
    "name": "CouchbaseLinkedService",
    "properties": {
        "type": "Couchbase",
        "typeProperties": {
            "connectionString": "Server=<server>; Port=<port>;AuthMech=1;",
            "credString": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

データセットのプロパティ

データセットを定義するために使用できるセクションとプロパティの完全な一覧については、データセットに関する記事をご覧ください。このセクションでは、Couchbase データセットでサポートされるプロパティの一覧を示します。

Couchbase からデータをコピーするには、データセットの type プロパティを CouchbaseTable に設定します。次のプロパティがサポートされています。

プロパティ	内容	必須
型	データセットの type プロパティは CouchbaseTable に設定する必要があります。	はい
テーブル名 (tableName)	テーブルの名前。	いいえ (アクティビティソースの "query" が指定されている場合)

例

{
    "name": "CouchbaseDataset",
    "properties": {
        "type": "CouchbaseTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Couchbase linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Copy アクティビティのプロパティ

アクティビティの定義に利用できるセクションとプロパティの完全な一覧については、パイプラインに関する記事を参照してください。このセクションでは、Couchbase ソースでサポートされるプロパティの一覧を示します。

ソースとしての CouchbaseSource

Couchbase からデータをコピーするには、コピーアクティビティのソースの種類を CouchbaseSource に設定します。コピーアクティビティの source セクションでは、次のプロパティがサポートされます。

プロパティ	内容	必須
型	コピーアクティビティのソースの type プロパティを CouchbaseSource に設定する必要があります	はい
クエリ	カスタム SQL クエリを使用してデータを読み取ります。 (例: `"SELECT * FROM MyTable"`)。	いいえ (データセットの "tableName" が指定されている場合)

例:

"activities":[
    {
        "name": "CopyFromCouchbase",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Couchbase input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "CouchbaseSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Lookup アクティビティのプロパティ

プロパティの詳細については、Lookup アクティビティに関するページを参照してください。

Copy アクティビティでソースおよびシンクとしてサポートされるデータストアの一覧については、サポートされるデータストアに関するセクションを参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-04-07