スプレッドシート・アドインのUIオプション

Spreadsheet Add-insは、複数の機能にまたがる共通UI要素と、個々のパネルに固有の追加コントロールを提供します。

接続情報

ほとんどのアドイン・パネルの上部セクションには、アクティブな接続に関する情報(データベースURL、スキーマ、接続ステータス、および接続が期限切れになるまでの残りのセッション時間など)が表示されます。OCI IAM接続の場合、接続ユーザーも表示されます。

ノート:

アドインはデータベースとのアクティブな接続を維持しますが、取得されるデータはスプレッドシートに対してローカルです。非アクティブまたは接続タイムアウトの場合、アドインは通知を表示し、データベースに再接続することを提案します。

SQLクエリー・エディタの使用

SQL問合せエディタは、SQL文の実行前にSQL文を記述、編集および表示する領域です。

問合せを手動で入力するか、オブジェクト・ブラウザから表、ビューおよび列を選択して、SQL文の作成に役立てることができます。SQL問合せエディタには、問合せの行番号と構文の強調表示が表示されます。

クエリー・エディタで使用可能なアクションは、使用しているアドイン機能によって異なります。一般に、SQL問合せエディタで次のオプションを使用できます。

  • 実行

    三角形の円として表示される最初のボタンは、「実行」ボタンです。このボタンをクリックすると、SQL文が実行され、選択したワークシートに問合せ結果が表示されます。

  • SQLコンテンツのクリア

    「実行」の横にある消しゴム・アイコンは、現在のSQL文を問合せエディタから削除します。

  • シートから問合せを取得

    このボタンは、アクティブなワークシートからSQL問合せを取得し、SQL問合せエディタに表示します。その後、問合せを編集して再度実行できます。

  • 表のハイパーリンクとして共有

    このオプションは、「直接SQL」および「データ分析」を使用して生成された問合せ結果にのみ使用できます。読取り専用問合せ結果をスプレッドシートにロードできるように、表ハイパーリンクを作成して他のユーザーと共有します。

ノート:

Excel用アドインには、アドイン・ウィンドウのリロードなどの追加オプションを含むフローティング・メニューが用意されています。アドイン・ウィンドウの右側にある小さな矢印をクリックして、フローティング・メニューを開きます。

問合せ結果のワークシートの選択

デフォルト・シートを使用するか、別のシートを選択して結果を表示できます。

ノート:

同じワークシートで別の問合せを実行すると、アドインによって、新しい問合せの結果でワークシートがリフレッシュされます。

別のクエリーに別のシートを使用するには、次のいずれかを実行します。

  • 「スプレッドシート・アドイン」でプラス(+)ボタンをクリックし、「新規ワークシートの追加」で名前を指定して、チェック・ボタンをクリックします。問合せを実行すると、アドインによって新しいシートが挿入されます。左矢印ボタンはキャンセルして戻ります。

  • ExcelまたはGoogle Sheetsのオプションを使用して、新しいシートを挿入します。

その後、「ワークシートの選択」から新しいシートを選択し、結果を表示できます。

情報の問合せ

ワークシートには、問合せ結果とともに次の問合せ情報も表示されます。

  • データベースのURL

  • 問合せを作成および実行するデータベース・ユーザーまたはスキーマ

  • 実際のSQL問合せ

  • リフレッシュ構成

  • クエリーの日時

SQL問合せでのバインド変数の使用

SQL問合せでバインド変数を使用して、実行時に値を指定できます。SQL文でバインド変数を定義するには、コロン(:)に続けて変数名を指定します。

例

SELECT *
FROM employees
WHERE city = :ct;

問合せを実行すると、アドインによって、バインド変数:ctの値を入力するよう求められます。Austinなどの値を指定すると、問合せはその値を使用して実行されます。結果とともに表示される問合せ情報には、バインド変数の割当て(:ct=Austinなど)が含まれます。

1つの問合せに複数のバインド変数を含めることができます。アドインは、バインド変数ごとに最近使用された値を保持します。問合せを再度実行する場合は、最近の値を選択するか、新しい値を入力できます。以前に保存した値を「問合せパラメータ」ダイアログからクリアすることもできます。

問合せ結果のリフレッシュ

「問合せのリフレッシュ」を使用すると、「直接SQL」、「データ分析」または「自然言語」パネルを開かずに、保存済問合せを再実行し、ワークシートで結果を更新できます。

問合せ結果をリフレッシュするには:

  1. 「スプレッドシート・アドイン」によって生成された問合せ結果を含むワークシートを選択します。

  2. 「問合せのリフレッシュ」をクリックします。

    アドインによって、保存済問合せが再実行され、現在のワークシートが最新の結果で更新されます。

ワークブックにリフレッシュ可能な問合せ結果を含む追加のワークシートが含まれている場合、アドインには残りのワークシートの数が表示され、それらのワークシートをリフレッシュするよう求められます。リフレッシュが完了すると、正常にリフレッシュされたワークシートを示すレポートがアドインに表示され、リフレッシュできなかったワークシートが識別されます。

ノート:

ワークシートは、対応するデータベース接続が保存され、接続されている場合にリフレッシュできます。「スプレッドシート・アドイン」は、その接続がアクティブな接続でない場合でも、保存された接続情報を使用して各ワークシートをリフレッシュします。

次のシナリオでは、リフレッシュ操作が失敗することがあります。

  • 保存されたビジュアライゼーションが、問合せによって返された列と一致しなくなりました。

  • ワークシートに関連付けられたデータベースURLおよびユーザーと一致する保存済接続はありません。

  • 必要なデータベース接続が切断されました。

リフレッシュ・レポートには、失敗したワークシートの詳細が表示されます。原因に応じて、問合せまたはビジュアライゼーションを更新したり、一致する保存済接続を追加またはインポートしたり、リフレッシュする前に必要なデータベース接続を再接続できます。

大規模データの処理

データ・セットが大きい問合せ(たとえば、10,000を超えるレコードを含む結果)の場合、結果全体を表示する場合、アドインには確認のためのウィンドウが表示されます。

ノート:

ピボットテーブルの操作中に、集計から正確な結果を得るために完全なデータをロードします。

親トピック: Spreadsheet Add-ins機能の使用