Azure Data Factory または Synapse Analytics を使用して Concur からデータをコピーする (プレビュー)

[アーティクル]
09/12/2024

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

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

重要

このコネクタは 2024 年 12 月 31 日に非推奨になります。この日付より前にドライバーをインストールして ODBC コネクタに移行することが推奨されます。

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

サポートされる機能

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

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

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

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

コネクタは、この記事の Windows バージョンをサポートしています。

Note

現在、パートナーアカウントはサポートされていません。

作業の開始

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

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

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

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

コネクタの構成の詳細

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

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

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

プロパティ	内容	必須
type	type プロパティは、次のように設定する必要があります:Concur	はい
connectionProperties	Concur への接続方法を定義するプロパティのグループ。	はい
`connectionProperties` の下:
authenticationType	使用できる値は `OAuth_2.0_Bearer` と `OAuth_2.0` です (レガシ)。 OAuth 2.0 認証オプションは、2017 年 2 月から非推奨となった古い Concur API で動作します。	はい
host	Concur サーバーのエンドポイント (例: `implementation.concursolutions.com`)。	はい
baseUrl	Concur の認可 URL のベース URL。	`OAuth_2.0_Bearer` 認証の場合、はい
clientId	Concur App Management によって提供されるアプリケーションクライアント ID。	はい
clientSecret	クライアント ID に対応するクライアントシークレット。このフィールドを SecureString とマークして安全に保存するか、Azure Key Vault に保存されているシークレットを参照します。	`OAuth_2.0_Bearer` 認証の場合、はい
username	Concur サービスへのアクセスに使用するユーザー名。	はい
password	username フィールドに指定したユーザー名に対応するパスワード。このフィールドを SecureString とマークして安全に保存するか、Azure Key Vault に保存されているシークレットを参照します。	はい
useEncryptedEndpoints	データソースのエンドポイントが HTTPS を使用して暗号化されるかどうかを指定します。既定値は、true です。	いいえ
useHostVerification	TLS 経由で接続するときに、サーバーの証明書内のホスト名がサーバーのホスト名と一致する必要があるかどうか指定します。既定値は、true です。	いいえ
usePeerVerification	TLS 経由で接続するときに、サーバーの ID を検証するかどうかを指定します。既定値は、true です。	いいえ

例:

{ 
    "name": "ConcurLinkedService", 
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "connectionProperties": {
                "host":"<host e.g. implementation.concursolutions.com>",
                "baseUrl": "<base URL for authorization e.g. us-impl.api.concursolutions.com>",
                "authenticationType": "OAuth_2.0_Bearer",
                "clientId": "<client id>",
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<client secret>"
                },
                "username": "fakeUserName",
                "password": {
                    "type": "SecureString",
                    "value": "<password>"
                },
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
}

例 (レガシ):

次に示すのは、connectionProperties なしで、OAuth_2.0 認証を使用するレガシのリンクされたサービスモデルであるので注意してください。

{
    "name": "ConcurLinkedService",
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "clientId" : "<clientId>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

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

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

Concur からデータをコピーするには、データセットの type プロパティを ConcurObject に設定します。この種類のデータセットに追加の種類固有のプロパティはありません。次のプロパティがサポートされています。

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

例

{
    "name": "ConcurDataset",
    "properties": {
        "type": "ConcurObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Concur linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

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

ソースとしての ConcurSource

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

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

例:

"activities":[
    {
        "name": "CopyFromConcur",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Concur input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ConcurSource",
                "query": "SELECT * FROM Opportunities where Id = xxx"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

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

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

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

次の方法で共有

Azure Data Factory または Synapse Analytics を使用して Concur からデータをコピーする (プレビュー)

サポートされる機能

作業の開始

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

コネクタの構成の詳細

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

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

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

ソースとしての ConcurSource

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

フィードバック

その他のリソース

次の方法で共有

Azure Data Factory または Synapse Analytics を使用して Concur からデータをコピーする (プレビュー)

サポートされる機能

作業の開始

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

コネクタの構成の詳細

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

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

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

ソースとしての ConcurSource

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

関連するコンテンツ

フィードバック

その他のリソース

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

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