Sources

Sources ページでは、データソース へのコネクションを作成・管理することができます。

Sources ページには、各コネクションに関する次の情報が含まれています：

• Connection Name—ユーザーが定義したコネクション名。
• Data Source—コネクションのデータソースの種類と、データソースがカスタムレポートをサポートしているかどうか。
• Status—コネクションのステータス。次のいずれかになります：
  • Authenticated—データソースへの接続は成功している。
  • Not Authenticated—Connect AI でコネクションは作成されたが、データソースの接続に成功していない。コネクションの編集画面に戻って認証することができます。Query ユーザーは、接続を認証するために管理者に連絡する必要があることに注意してください。
  • Conditional—接続は、コネクタに追加されたグローバル設定とテーブルに基づいて条件付きである。これはAPI コネクタで発生します。
• Last Modified—ユーザーが最後にコネクションを更新した日時。

コネクションの追加

新しいコネクションを追加するには、次の手順を実行します。

1. Sources ページでAdd Connection をクリックします。これによりAdd Connection ダイアログが表示されます。

2. ダイアログ内のリストからデータソースを選択するか、名前でコネクションを検索します。

   

データソースを選択すると、当該データソース用のEdit Connection ページが表示されます。

1. データソースの説明 に従ってコネクションを設定します。コネクションを設定するための手順は、設定ページの右側のペインのDocumentation タブに表示されます。

2. Save and Test をクリックします。

接続に成功すると、Connection successfully saved というメッセージが表示されます。Edit Connection ページの右ペインにあるData Model タブで、コネクションのデータモデルを表示することもできます。メインのSources ページに戻ると、Sources 一覧に新しいコネクションが表示されます。一覧の編集または削除用アイコンをクリックすることで、いつでもコネクションを編集または削除することができます。

接続に失敗すると、ユーザーインターフェースには、データが不足しているフィールドの下にエラーメッセージが表示されます。一部のデータソースでは、データソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、ユーザーインターフェースには、Sign in ボタンの下にエラーメッセージが表示されます。

状況によっては、コネクションのメタデータキャッシュをリフレッシュすることで、Connect AI アプリケーションの読み込みやパフォーマンスの問題を解決できる場合があります。メタデータキャッシュをリフレッシュするには、Edit Connection ページの上部にあるRefresh Metadata をクリックします。メタデータキャッシュのリフレッシュが成功したことを示すバナーが表示されます。

Note: コネクションを編集または削除しようとしたときに、Connect AI が現在のコネクションからキャッシュされたジョブを見つけた場合は、警告が表示されます。キャンセルするか、変更を続行するかを選択できます。変更を保存すると、Connect AI は現在のコネクションからキャッシュされたデータをクリアします。

接続に失敗すると、下書きとして保存されます。下書きのコネクションはEdit Connection ページとメインのSources ページにNot Authenticated として表示されます。後でコネクションを編集して認証プロセスを完了できます。

Query ユーザーは、下書きのコネクションを認証するためにアカウントの管理者に連絡する必要があります。

権限の付与

コネクションを作成または編集する場合、Permissions タブに利用可能なユーザーのリストが表示され、それぞれに権限を割り当てることができます。権限の内容は以下のとおりです。

• Select： コネクション内のテーブルから行を選択できます。
• Insert： コネクションのテーブルに行を挿入できます。
• Update： コネクションのテーブル内の行を更新できます。
• Delete： コネクション内のテーブルから行を削除できます。
• Execute： ユーザーがコネクション内のストアドプロシージャを実行できます。
  

4つの方法で権限を切り替えることができます。

• テーブル内の個々のボックスをクリックすると、1人のユーザーに対してその権限が有効 / 無効になります。
• テーブルのカラム上部にあるダブルチェックマークをクリックすると、すべてのユーザーに対してその権限が有効 / 無効になります。
• テーブルの右側にあるダブルチェックマークをクリックすると、1人のユーザーに対するすべての権限が有効 / 無効になります。
• テーブルの右上にあるAll と書かれたダブルチェックマークをクリックすると、全ユーザーのすべての権限が有効 / 無効になります。

カスタムレポートの設定

一部のデータソースはカスタムレポート をサポートしています。これにより、コネクション内でビューとしてクエリできる定義済みレポートを構成できます。各レポートには固有の必須インプットセットがあり、Connect AI アカウントでレポートを構成するときにこれらのインプットを指定します。

カスタムレポートは、一般的に次の2種類のシナリオで役立ちます。

• 広告や分析データソースの場合、一連のメトリクスやディメンションを事前定義しておくことで、パフォーマンスデータの集計レポートを表示できます。
• その他の種類のデータソースでは、パラメータを事前定義してデータレポートを作成できます。例えば、会計API を使用すると、QuickBooks で総勘定元帳レポートを作成できる場合があります。

カスタムレポートの作成

データソースがカスタムレポートをサポートしている場合、コネクションの設定ページにCustom Reports タブが表示されます。このタブをクリックすると、以下に示すようなカスタムレポートのインターフェースが表示されます。

カスタムレポートを追加するには、以下の手順に従います。

1. Report テーブルの上にあるAdd をクリックします。選択したデータソースで利用可能なカスタムレポートのリストを含むダイアログが表示されます。

   
2. 使用するレポートを選択し、Confirm をクリックします。カスタムレポートの必須フィールドとオプションフィールドのリストが表示されます。

3. 必要な情報を入力し、Save をクリックして、アカウントにカスタムレポートを保存します。

カスタムレポートを保存すると、コネクションのテーブルのリストに表示されます。必要に応じて、カスタムレポートを削除したり新しいレポートを追加したりできます。

カスタムレポートは、同じデータソースへの複数のコネクションにまたがって共有されることはありません。例えば、Adobe Analytics に2つの別々のコネクションがある場合、各コネクションにはそれぞれ独自のカスタムレポートのリストが存在します。

カスタムレポートの使用

クエリのテーブルフィールドにカスタムレポートの名前を渡すことで、保存されたカスタムレポートをクエリできます。例えば、QuickBooks Online コネクションにCustomer Accounts List というカスタムレポートがある場合、次のクエリでその結果をすべてSELECT できます。

SELECT * FROM [QuickBooksOnline1].[QuickBooksOnline].[Customer Accounts List]

カスタムレポートの編集

既存のカスタムレポートを編集するには、以下の手順に従います。

1. レポートテーブルで、編集するレポートを見つけます。

2. レポートの名前または種類をクリック、もしくは編集ボタンをクリックします。

3. Edit Custom Report で、レポートパラメータを追加または変更します。

4. 変更を保存をクリックします。

カスタムレポートを既存のレポートから複製

既存のカスタムレポートを複製するには、以下の手順に従います。

1. レポートテーブルで、複製するレポートを見つけます。

   
2. 複製ボタンをクリックします。Connect AI は、新しい名前でデータソースの複製カスタムレポートを作成します。

3. 必要に応じてReport Name を編集し、Save をクリックします。

カスタムレポートの削除

既存のカスタムレポートを削除するには、以下の手順に従います。

1. レポートテーブルで、削除するレポートを見つけます。

2. レポートの右側にある削除ボタンをクリックします。あるいは、Edit Custom Report ページでDelete をクリックすることもできます。

3. ダイアログで再度Delete をクリックして確定します。