Azure Data Factory または Synapse Analytics を使用して Vertica からデータをコピーする

適用対象: Azure Data Factory Azure Synapse Analytics

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

サポートされる機能

この Vertica コネクタでは、次の機能がサポートされています。

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

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

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

バージョン 2.0 (プレビュー) では、Vertica ODBC ドライバーを手動でインストールする必要があります。 バージョン 1.0 の場合、このサービスでは接続を有効にする組み込みのドライバーが提供されるので、ドライバーを手動でインストールする必要はありません。

前提条件

データ ストアがオンプレ ミスネットワーク、Azure 仮想ネットワーク、または Amazon Virtual Private Cloud 内にある場合は、それに接続するようセルフホステッド統合ランタイムを構成する必要があります。 バージョン 2.0 (プレビュー) を使用する場合、セルフホステッド統合ランタイムのバージョンは 5.44.8984.1 以降である必要があります。

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

バージョン 1.0 の場合

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

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

バージョン 2.0 (プレビュー) 用の Vertica ODBC ドライバーをインストールする

バージョン 2.0 (プレビュー) で Vertica コネクタを使用するには、次の手順に従って、セルフホステッド統合ランタイムを実行しているコンピューターに Vertica ODBC ドライバーをインストールします。

1. ODBC ドライバーの Vertica クライアント セットアップを Client ドライバー | OpenText™ Vertica™ からダウンロードします。 Windows システムのセットアップの例を次に示します。

   

2. ダウンロードした .exe を開き、インストール プロセスを開始します。 

   

3. Vertica コンポーネントの一覧から ODBC ドライバーを選択し、[次へ] を選択してインストールを開始します。

   

4. インストール プロセスが正常に完了したら、スタート メニュー -> [ODBC データ ソース管理者] に移動して、正常にインストールされたことを確認できます。

   

作業の開始

コピー アクティビティを含むパイプラインは、.NET SDK、Python SDK、Azure PowerShell、REST API、または Azure Resource Manager テンプレートを使用して作成できます。 コピー アクティビティを含むパイプラインを作成するための詳細な手順については、コピー アクティビティのチュートリアルをご覧ください。

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

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

1. Azure Data Factory または Synapse ワークスペースの [管理] タブに移動し、[リンクされたサービス] を選択して、[新規] をクリックします。

   • Azure Data Factory
   • Azure Synapse

   

2. Vertica を検索し、Vertica コネクタを選択します。

   

3. サービスの詳細を構成し、接続をテストして、新しいリンク サービスを作成します。

   

コネクタの構成の詳細

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

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

バージョン 2.0 (プレビュー) を使用する場合、Vertica のリンク サービスでは次のプロパティがサポートされます。

例:

{
    "name": "VerticaLinkedService",
    "properties": {
        "type": "Vertica",
        "version": "2.0",
        "typeProperties": {
            "server": "<server>",
            "port": 5433,
            "uid": "<username>",
            "database": "<database>",
            "pwd": {
                "type": "SecureString",
                "value": "<password>"
             }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

例: パスワードを Azure Key Vault に格納する

{
    "name": "VerticaLinkedService",
    "properties": {
        "type": "Vertica",
        "version": "2.0",
        "typeProperties": {
            "server": "<server>",
            "port": 5433,
            "uid": "<username>",
            "database": "<database>",
            "pwd": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

バージョン 1.0 を使用する場合は、次のプロパティがサポートされます。

例:

{
    "name": "VerticaLinkedService",
    "properties": {
        "type": "Vertica",
        "typeProperties": {
            "connectionString": "Server=<server>;Port=<port>;Database=<database>;UID=<user name>;PWD=<password>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

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

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

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

例

{
    "name": "VerticaDataset",
    "properties": {
        "type": "VerticaTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Vertica linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

コピー アクティビティのプロパティ

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

ソースとしての Vertica

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

例:

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

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

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

Vertica バージョンをアップグレードする

Vertica バージョンのアップグレードに役立つ手順を次に示します。

1. 「前提条件」の手順に従って、Vertica ODBC ドライバーをインストールします。
2. [リンク サービスの編集] ページの [バージョン] で [2.0 (プレビュー)] を選び、「リンク サービスのプロパティ」を参照してリンク サービスを構成します。
3. バージョン 5.44.8984.1 以上のセルフホステッド統合ランタイムを適用します。 Azure 統合ランタイムは、バージョン 2.0 (プレビュー) ではサポートされていません。

関連するコンテンツ

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