Azure Data Factory または Synapse Analytics を使用して TeamDesk (プレビュー) のデータを変換する

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

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

この記事では、Data Flowを使用して TeamDesk (プレビュー) のデータを変換する方法について説明します。 詳細については、Azure Data Factory または Azure Synapse Analytics の入門記事を参照してください。

重要

このコネクタは、現在プレビューの段階です。 実際にお試しいただき、フィードバックをお寄せください。 ソリューションのプレビュー コネクタに依存する場合は、Azure support にお問い合わせください。

サポートされる機能

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

サポートされる機能 IR
マッピング データ フロー (ソース/-) ①

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

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

UI を使用して TeamDesk のリンクされたサービスを作成する

Azure ポータル UI で TeamDesk のリンクされたサービスを作成するには、次の手順に従います。

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

    Azure Data Factory の UI を使用して新しいリンクされたサービスを作成する画面

  2. TeamDesk (プレビュー) を検索し、TeamDesk (プレビュー) コネクタを選択します。

    TeamDesk コネクタの選択を示すスクリーンショット。

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

    TeamDesk のリンク サービスの構成のスクリーンショット。

コネクタの構成の詳細

以下のセクションでは、TeamDesk に固有の Data Factory および Synapse パイプライン エンティティの定義に使用されるプロパティについて説明します。

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

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

プロパティ 内容 必須
型 type プロパティは TeamDesk に設定する必要があります。 はい
url TeamDesk データベースの URL。 たとえば https://www.teamdesk.net/secure/db/xxxxx です。 はい
認証タイプ TeamDesk サービスへの接続に使用される認証の種類。 使用可能な値は basic および token です。 それぞれのプロパティとサンプルについては、以下の対応するセクションを参照してください。 はい

基本認証

authenticationType プロパティを basic に設定します。 前のセクションで説明した汎用的なプロパティに加えて、次のプロパティを指定します。

プロパティ 内容 必須
userName TeamDesk にログインするために使用するユーザー名。 はい
パスワード ユーザー名に指定したユーザー アカウントのパスワードを指定します。 安全に保存するには、このフィールドを SecureString としてマークします。 または、Azure Key Vaultに格納されているシークレットを参照することもできます。 はい

例:

{
    "name": "TeamDeskLinkedService",
    "properties": {
        "type": "TeamDesk",
        "typeProperties": {
            "url": "https://www.teamdesk.net/secure/db/xxxxx",
            "authenticationType": "basic",
            "userName": "<user name>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

認証トークン

authenticationType プロパティを token に設定します。 前のセクションで説明した汎用的なプロパティに加えて、次のプロパティを指定します。

プロパティ 内容 必須
apiToken TeamDesk の API トークンを指定します。 安全に保存するには、このフィールドを SecureString としてマークします。 または、Azure Key Vaultに格納されているシークレットを参照することもできます。 はい

例:

{
    "name": "TeamDeskLinkedService",
    "properties": {
        "type": "TeamDesk",
        "typeProperties": {
            "url": "https://www.teamdesk.net/secure/db/xxxxx",
            "authenticationType": "token",
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

データフロー マッピングのプロパティ

マッピング データ フローでデータを変換する場合、TeamDesk からテーブルの読み取りができます。 詳細については、マッピング データ フローのソース変換に関するページを参照してください。 インライン データセットは、ソースの種類としてのみ使用できます。

ソース変換

次の表に、TeamDesk ソースでサポートされるプロパティの一覧を示します。 これらのプロパティは、 [ソース オプション] タブで編集できます。

名前 内容 必須 使用できる値 データ フロー スクリプトのプロパティ
テーブル データ フローでは、ソース オプションで指定されたテーブルからすべてのデータをフェッチします。 インラインモードを使用する場合は、はい - テーブル
表示 データフローは、ソース オプションで指定されたテーブル内にある指定のビューを取得します。 いいえ - ビュー

TeamDesk のソース スクリプトの例

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'teamdesk',
	format: 'rest',
	table: 'Table',
	view: 'View') ~> TeamDesksource

関連するコンテンツ

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

  • Last updated on