Documentation Index
Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Connect AI でGoogle Sheets（スプレッドシート） を設定して使用する前に、データソースをConnect AI アカウントに接続する必要があります。詳細は、Sources を参照してください。
Connect AI ユーザーのみ： また、ワークスペースとDerived View をインポートすることもできます。ワークスペースを作成するには、Workspaces の指示に従ってください。Derived view を作成するには（管理者のみ）、Derived View の作成の指示に従ってください。
インストールとセットアップ
スプレッドシートが開いたら、拡張機能 > アドオン > アドオンを取得を選択します。 検索バーでCData と検索し、CData Connect Spreadsheets アドオンをクリックします。 ポップアップ画面で、インストールをクリックし、続けるをクリックします。
必要であればGoogle アカウントを選択しサインインします。コネクション承認用のプロンプトが表示されたら、許可をクリックします。
スプレッドシートに戻ります。拡張機能 > CData Connect Spreadsheets > 開くを選択します。
スプレッドシートの右側に設定画面が表示されます。Authorize をクリックしCData Connect Spreadsheets にサインインします。
CData Connect Spreadsheets の認証情報を入力し、Continue をクリックします。
認証成功のメッセージが表示されたら、タブを閉じてGoogle スプレッドシートに戻ります。
接続の設定
まだCData Connect Spreadsheets に必要なデータを接続していない場合は、設定する必要があります。
アドインペインでConnections をクリックします。Add Connectionをクリックします。
Google Sheets（スプレッドシート） に接続するデータ用のコネクタを選択します。
データ接続文字列を入力します。保存して接続をテストします。
接続に成功したら、データのインポートができます。 You can also use the Connections option to edit existing connections.
データのインポート
データ接続からデータをインポートするには、以下の手順に従います：
ドロップダウンメニューからオプションを1つ選択します：Connections、Workspaces、Derived Views。次に、選択した各オプションの手順に従います。
ワークスペースおよびDerived view にアクセスできるのは、Connect AI ユーザーのみです。
Connections のインポート
ドロップダウンリストからConnection を選択します。
Query Builder またはCustom SQL のいずれかを選択します。
- Query Builder では、スキーマ（複数ある場合）、テーブル、およびカラムを選択します。必要に応じてフィルタ、ソート、およびLimit を設定できます。生成されたクエリを表示し、必要に応じて調整します。
- Custom SQL では、SQL ステートメントを所定のテーブルに入力します。
プロンプトが表示されたら、現在のスプレッドシートまたは新しいスプレッドシートのいずれかをデータの出力先として選択します。
Workspaces のインポート（Connect AI ユーザーのみ）
ドロップダウンリストからワークスペースを選択します。
Query Builder またはCustom SQL のいずれかを選択します。
- Query Builder では、表示するワークスペースとカラムを選択します。必要に応じてフィルタ、ソート、およびLimit を設定できます。生成されたクエリを表示し、必要に応じて調整します。
- Custom SQL では、SQL ステートメントを所定のテーブルに入力します。
プロンプトが表示されたら、現在のスプレッドシートまたは新しいスプレッドシートのいずれかをデータの出力先として選択します。
Query Builder またはCustom SQL のいずれかを選択します。
- Query Builder では、表示するDerived View とカラムを選択します。必要に応じてフィルタ、ソート、およびLimit を設定できます。生成されたクエリを表示し、必要に応じて調整します。
- Custom SQL では、SQL ステートメントを所定のテーブルに入力します。
プロンプトが表示されたら、現在のスプレッドシートまたは新しいスプレッドシートのいずれかをデータの出力先として選択します。
データのリフレッシュ
元のデータソースからスプレッドシートにインポート済みのデータをアップデートするには、CData Connect Spreadsheets アドオンのメインメニューにあるRefresh をクリックします。（必要に応じて、戻る矢印をクリックしてアドオンのメインメニューに戻ります。）続いて、以下の手順に従います：
アップデートしたいスプレッドシートの隣にあるチェックボックスを選択します。 更新のオプションを選択します：
- Refresh Now をクリックすると手動でデータを即座に更新します。
- Auto Refresh をクリックすると自動更新の間隔を1時間単位で選択できるダイアログが開きます。ここで設定した間隔は自動更新を使用するすべてのスプレッドシートに適用されます。
選択したスプレッドシートのデータが最新にアップデートされます。
Auto Refresh が選択されると新たにAuto Refresh Status のフィールドが表示されます。このフィールドでは更新の間隔と更新の対象となるスプレッドシートが記載されます。Reset Auto Refresh ボタンで現在の自動更新を停止し、新しい自動更新を設定できます。
データの更新
Google Sheets スプレッドシートから元のデータ接続に変更をプッシュできます。スプレッドシートを更新するには、データに少なくとも1つの主キーが含まれていなければならないことに注意してください。また、ソースデータを更新するための適切な権限が必要です。元のデータ接続の読み取り専用フィールドは更新できません。
自動更新機能を使用している場合は、データを頻繁に更新してください。そうしないと、変更が元のデータ接続によって上書きされる可能性があります。
CData Connect Spreadsheets はビューの更新をサポートしていません（テーブルのみ）。
Google Sheets スプレッドシートに変更を加えます。データを更新すると、そのデータが元のデータ接続にまだ更新されていないことを示すために赤色でハイライト表示されます。
選択した行のみを更新する場合は、更新するセルまたは行をハイライト表示します。
CData Connect Spreadsheets アドオンペインでUpdate をクリックします。
選択した行を更新Update Selected するか、すべての行を更新Update All するか決定します。
Execute をクリックします。Confirm をクリックして続行します。このアクションにより、元のデータ接続が更新され、元に戻すことはできません。
CData Connect Spreadsheets は、更新が成功したかどうかのメッセージを返します。失敗した場合、CData Connect Spreadsheets は更新に失敗した理由を表示します。
更新が成功すると、赤色のデータが黒色に変わります。これは、元のデータ接続でデータが更新されたことを示します。
データの挿入
スプレッドシートに行を挿入するには、以下の手順に従います：
必要に応じて、CData Connect Spreadsheets アドオンのメインメニューに戻ります。
Google スプレッドシートの機能を使用して、スプレッドシートに行を挿入します（挿入 > 行）。
行に情報を入力します。データを追加すると、そのデータが元のデータ接続にまだ更新されていないことを示すために赤色でハイライト表示されます。
挿入した行のみを更新する場合は、その行をハイライト表示します。
CData Connect Spreadsheets アドオンペインでUpdate をクリックします。
選択した行を更新Update Selected するか、すべての行を更新Update All するか決定します。
Execute をクリックします。Confirm をクリックして続行します。このアクションにより、元のデータ接続にデータが挿入され、元に戻すことはできません。
CData Connect Spreadsheets は、挿入が成功したかどうかのメッセージを返します。失敗した場合、CData Connect Spreadsheets は挿入に失敗した理由を表示します。
挿入が成功すると、赤色のデータが黒色に変わります。これは、元のデータ接続でデータが更新されたことを示します。
データの削除
CData Connect Spreadsheets does not support deletion for views (only tables).
必要に応じて、CData Connect Spreadsheets アドオンのメインメニューに戻ります。
削除する行を選択し、Delete をクリックします。行内の任意のセルを選択すると、CData Connect Spreadsheets は行全体を削除します。CData Connect Spreadsheets は、指定した行数を削除してもよいかどうかを確認するプロンプトを表示します。
削除を続行するにはConfirm をクリックします。CData Connect Spreadsheets は、行の削除に成功したかどうかを表示します。
- クエリを実行した日時
- クエリ結果（成功 / 失敗）
- クエリの内容とパラメータ
詳しくはLogs を参照してください。
クエリの詳細設定
データをインポートする際、クエリをビルドするためにフィルタ とソート が使用できます。
フィルタ
フィルタを追加するには、Filters ヘッダーの隣の + をクリックします。+ を再度クリックすることでさらにフィルタを追加することができ、フィルタの横にあるゴミ箱のアイコンをクリックすると、フィルタを削除できます。
各フィルタには以下の3つの入力項目があります：
- Column—フィルタをかけたいカラムをテーブルから選択します。
- Op—フィルタが実行するオペレーションを選択します。オプション：equals、does not equal、contains、does not contain、less than、less than or equal to、greater than、greater than or equal to
- Value—フィルタ操作の値を表示します。
例えば、AccountValues が$100,000を超えるものを取り出したい場合、Column をAccountValues、Op をgreater than、そしてValue を100,000 にそれぞれ設定します。この設定をすることでクエリを実行したときにフィルタにマッチした結果のみが返されます。
フィルタのパラメータを入力すると、画面下部のGenerated Query が自動的にアップデートされます。
ソート
クエリ結果にソートルールを追加するには、Sort By ヘッダーの隣の + をクリックします。+ を再度クリックすることでさらにソートルールを追加することができ、ソートルールの横にあるゴミ箱のアイコンをクリックすると、ソートルールを削除できます。
各ソートルールはColumn とOrder（昇順または降順）の選択が必要です。複数のソートルールを追加する場合は、ルールが表示されている順で結果がソートされます。クエリは、最初のルールを最も優先してソートし、次に2番目のルール、といった順番でソートされます。
ソートのパラメータを入力すると、画面下部のGenerated Query が自動的にアップデートされます。
