注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
CData JDBC ドライバーを使用して Foundry を Asana に接続し、Foundry データセットにデータをインポートします。
| 機能 | ステータス |
|---|---|
| 一括インポート | 🟢 一般的に利用可能 |
| 探索 | 🟢 一般的に利用可能 |
| 増分 | 🟢 一般的に利用可能 |
CData ドライバーは、Asana データをリレーショナルデータベースのテーブルリストとしてモデル化し、標準的な SQL 文でクエリを実行することができます。利用可能なテーブルとその内容については、CData のドキュメンテーションで Asana テーブル（外部）を確認してください。
Foundry での コネクタの設定 について詳しく知る。
Asana への認証は、個人またはサービスのアクセストークンで行われます。
サービスアカウントまたは個人アクセストークンを生成するには、Asana のドキュメンテーション内のガイドに従ってください：
Asana コネクタは、ポート 443 の app.asana.com へのネットワークアクセスを必要とします。インターネットを介した直接接続を使用している場合は、出口ポリシー が存在することを確認します。エージェントランタイムの場合、エージェントを実行しているサーバーは、このドメインへのネットワークアクセスを持っている必要があります。
Asana コネクタには以下の設定オプションがあります：
| オプション | 必須？ | 説明 |
|---|---|---|
Project ID | はい | Asana のプロジェクトの URL でプロジェクト ID を見つけます。例：https://app.asana.com/0/PROJECT_ID/list |
資格情報設定 | はい | 上記の 認証 のガイダンスを使用して設定します。 |
プロキシ設定 | いいえ | Asana へのプロキシ接続を許可するために有効化し、ユーザー名とパスワードを入力します。 |
ログ | いいえ | コネクタが情報をログに記録する方法を制御するために有効化します。詳細は下記の ログ設定 セクションを参照してください。 |
接続のトラブルシューティングに詳細なログが必要な場合があります。詳細度レベル 設定を使用して、ログに記録する情報の量を増減させます。
ログの詳細度を増やすと、機密情報が Foundry のビルドログに保存される可能性があります。これらのログを共有する前に、必要に応じてパスワードを削除してください。CData のドキュメンテーションで、異なる 詳細度レベル について詳しく学ぶ（外部）。
Asana の同期を設定するには、ソースの Overview 画面の右上で Explore and create syncs を選択します。次に、Foundry に同期したいテーブルを選択します。同期する準備ができたら、Create sync for x datasets を選択します。
Foundry での ソース探索 について詳しく知る。
Asana コネクタでは、どのデータをどの程度 Foundry に取り込むかを決定するための高度な同期設定が可能です。
利用可能なテーブルを探索し、それらを接続に追加した後、Edit syncs に移動します。左側の Syncs パネルから設定したい同期を見つけ、右側の > を選択します。
| オプション | 必須？ | 説明 |
|---|---|---|
テーブル | はい | Asana から Foundry にコピーするテーブルを選択します。サポートされているテーブルについては、データモデル を参照してください。 |
行選択 | いいえ | Foundry に同期する列のサブセットを選択します。詳細は下記の 行選択 セクションを参照してください。 |
行フィルター | いいえ | 有効にし、その行の列の値に基づく基準に合わない行を削除するためのフィルターを追加します。詳細は下記の 行フィルター セクションを参照してください。 |
Limit | いいえ | 基本的なクエリに SQL の limit 句を追加します。この設定は、単一の実行で Foundry に同期する行の数を制限するために使用できます。 |
増分 | いいえ | データを少量ずつ Foundry に同期するために有効にします。詳細は下記の 増分 セクションを参照してください。 |
通常、同期はターゲットテーブルから一致するすべての行をインポートします。同期間にデータが変更されたかどうかに関係なくです。それに対して、増分同期は最新の同期に関する状態を保持し、ターゲットから新しい一致する行だけを取り込みます。
増分同期は、Asana から大規模なテーブルを取り込む場合に使用できます。増分同期を使用するには、テーブルに厳密に単調増加する列が含まれている必要があります。さらに、読み込み対象のテーブルには、以下のデータ型の列が含まれている必要があります：
DATETIMESTAMP数値型の列：
intTINYINTSMALLINTINTEGERlongBIGINTNUMERICNUMBERDECIMALDEC文字列型の列：
stringVARCHARCHARNVARCHARNCHARLONGNVARCHARLONGVARCHAR増分同期には以下の設定が必要です：
| オプション | 必須？ | 説明 |
|---|---|---|
| 列 | はい | 増分取り込みに使用される列を選択します。テーブルがサポートされている列のタイプを含まない場合、ドロップダウンは空になります。 |
初期値 | はい | データの同期を開始する値。 |
例： 5TB のテーブルには、Asana に同期したい数十億行が含まれています。テーブルには id という 単調増加列 があります。同期は、id 列を 増分列 として使用し、初期値を -1、制限を 5000 万行に設定して、一度に 5000 万行を取り込むように設定できます。
同期が初めて実行されると、id の値が -1 より大きい最初の 5000 万行（id に基づいて昇順）が Foundry に取り込まれます。例えば、この同期が数回実行され、最後の同期で取り込まれた最大の id が 19384004822 だった場合、次の同期では 19384004822 より大きい最初の id から始まる次の 5000 万行が取り込まれます、という具体的な動作になります。
Foundry に同期する列を選択します。列が選択されていない場合、すべての列が Foundry に同期されます。
すべての列名はアンダースコアまたは英字から始まらなければなりません。名前にはアンダースコア、英字、数字のみを含めることができます。
以下の例は有効な列名です：
_colum_namea_column_name_123以下の例は無効な列名です：
1ColumnName；数字から始まります。a-column-name*；ハイフンとアスタリスクを含みます。å-column-name；英語以外の文字を含みます。フィルターを追加して、どの行を Foundry に同期するかを選択し、その量を減らすことができます。行フィルターを設定するには、テーブルのプレビューが成功している必要があります。行フィルターを設定する前に、インターフェースの下部にある Preview of inbound data セクションを使用してプレビューを更新することをお勧めします。プレビューは、追加されたフィルターの動作を検証するために更新できます。
フィルター設定は、それぞれの行が Foundry に同期されるために通過しなければならない一連の条件から成ります。各条件セットは、すべて の条件が一致する場合または 少なくとも一つ の条件が一致する場合に評価できます。条件のセットはネストでき、何をインポートするかについてより細かい制御を提供し、非常に高い柔軟性を提供します。これらは、標準 SQL の AND および OR 文に相当します。
条件自体は、Asana のテーブルの列の値とインターフェースに入力できる値との簡単な比較です。例えば、条件 CreatedAt が 12/04/2021 に等しい場合、CreatedAt 列の値が 12/04/2021 である行だけがインポートされます。列のデータ型がサポートする比較操作を決定します。
フィルターでは以下の操作がサポートされています：
EQUAL TOGREATER THANLESS THANGREATER THAN OR EQUAL TOLESS THAN OR EQUAL TONOT EQUAL TOIS NULLIS NOT NULLこれらの比較操作は、これらの操作が標準 SQL で行う動作と同等です。
文字列型の列はさらに Like および Not like 演算子をサポートしており、これらは標準 SQL-92 構文を使用します。