SQL問合せの保存、共有およびエクスポート

SQL問合せはいつでも保存でき、後から操作を続行できます。また、完了した問合せを保存し、自分または他のユーザーが将来使用できるように検索ウィジェットとして問合せを共有することもできます。

固定した時間範囲に基づいてウィジェットを作成した場合、ウィジェットを開くたびに、検索で指定した時間範囲の結果が表示されます。デフォルトでは、相対的な期間(たとえば過去7日間)のウィジェットを作成した場合、ウィジェットを開くたびに、時間セレクタ(過去7日間)に従って最新の結果が表示されます。ダッシュボードで参照されるウィジェットには、ページ時間セレクタ設定が反映されます。

前提条件:

ダッシュボードの操作に必要な権限を割り当てる管理ダッシュボード・ポリシーの詳細は、管理ダッシュボードの詳細を参照してください。
管理ダッシュボードAPIのドキュメントは、管理ダッシュボードAPIを参照してください。

SQLエクスプローラの「アクション」メニューを使用すると、SQL検索を保存して他のユーザーと共有できます。

完了した検索の保存とダッシュボードへの追加

SQL問合せを保存してダッシュボードに追加するには:

「アクション」メニューで「保存」を選択します。「検索の保存」ダイアログが表示されます。
検索を保存するコンパートメントを選択してください。
ノート

保存検索の選択されたコンパートメントと、問合せ対象の基礎となるデータとの間には関連付けはありません。
ウィジェットの「名前」および「説明」を入力します。
オプションで、検索ウィジェットを保存してダッシュボードに追加できます。
「ダッシュボードに追加」オプションをクリックします。
既存のダッシュボードにウィジェットを追加するか(ダッシュボード・コンパートメントと特定のダッシュボードを選択)、新しいダッシュボードを作成して必要な情報を提供するかを選択します。
ノート

Opsインサイトには、Exadata用の次の即時利用可能なダッシュボードが用意されています:
- Exadataセル・ダッシュボード - 時間単位
  セル・ディスク・メトリックの時間単位の粒度ダッシュボード。
- Exadata IORMダッシュボード - 時間単位
  Exadata IORM関連メトリックの時間単位の粒度ダッシュボード。
「保存」をクリックします。

以前に保存または事前定義された検索を開く

「アクション」メニューから、「開く」を選択します「検索のオープン」ダイアログが表示されます。
以前に保存した検索、またはSQLエクスプローラに付属の事前定義済検索ウィジェットの1つを選択します。
「開く」をクリックします

保存された検索の削除

「アクション」メニューから、「削除」を選択します「検索の削除」ダイアログが表示されます。
以前に保存した検索を選択します。
「削除」をクリックします。

重要: 既存のダッシュボードによって現在参照されている保存済検索ウィジェットを削除する場合は、ダッシュボードから自動的に削除されないことに注意してください。これにより、ダッシュボードへのアクセス時にエラーが発生します。

ノート

事前定義済の即時利用可能な検索は削除できません。

既存の保存済検索問合せからの作成

「Save As」オプションを使用して、既存のものからカスタマイズされた検索を作成できます。

「アクション」メニューから、「開く」を選択します「検索のオープン」ダイアログが表示されます。
リストから以前に保存または事前定義された検索を選択します。
「開く」をクリックします検索基準がSQLエクスプローラに表示されます。
必要に応じて、検索条件を更新します。
「処理」メニューから「別名保存」を選択します。
更新された検索の新しい名前を入力します。
「保存」をクリックします。

既存の検索の名前と説明の更新

SQL問合せの開発中に、検索ウィジェットの名前および関連する説明情報を変更できます。これらの変更を行うには、「編集」オプションを使用します。

既存の検索ウィジェットを更新する場合は、「アクション」メニューから「開く」を選択します。「検索のオープン」ダイアログが表示されます。
検索ウィジェットが存在するコンパートメントを選択します。
ノート

保存検索の選択されたコンパートメントと、問合せ対象の基礎となるデータとの間には関連付けはありません。
検索ウィジェットを選択し、「開く」をクリックしてSQLエクスプローラで検索を表示します。
「アクション」メニューから、「編集」を選択します。「検索の編集」ダイアログが表示されます。
「新規検索名」または「新規検索の説明」(あるいはその両方)を入力します。
「編集」をクリックして変更を保存します。

新規検索の作成

既存の検索基準をクリアして新しい検索を開始するには、「アクション」メニューから「新規作成」を選択します。

データのエクスポート

検索から取得したデータをエクスポートするには、「保存済検索」メニューの「CSVにエクスポート」をクリックします。データ・エクスポートには、1つの問合せ(limit=1000およびpages=10を使用)に対して最大10,000行のみフェッチできるという制限があります。または、CLI (コマンドライン・インタフェース)を介してデータをエクスポートできます。CLI経由のエクスポートは非常に強力で使いやすいです。CLIを使用してデータを取得する方法については、次のサンプルを参照してください。

JSONファイルを使用するサンプル:

oci opsi
opsi-data-objects query-data-templatized-query 
--from-json file://./<file name>
--compartment-id <compartment id>
--limit 1000

JSONファイルの内容は次のとおりです。

{
   "dataObjectIdentifier":"opsidataobject.dbinsights.f0819908-5ae3-4cb5-8a81-80a4ba888881",
   "query":{
      "queryType":"TEMPLATIZED_QUERY",
      "selectList":[
         "DB_DISPLAY_NAME, CDB_NAME, EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC"
      ],
      "whereConditionsList":[
          
      ],
      "groupByList":[
          
      ],
      "havingConditionsList":[
          
      ],
      "orderByList":[
         "ROLLUP_TIME_UTC ASC"
      ],
      "timeFilters":{
         "timeStart":"2024-01-05T00:00:00.000Z",
         "timeEnd":"2024-01-12T00:00:00.000Z"
      }
   },
   "resourceFilters":{
      "compartmentIdInSubtree":false
   }
}

CLIコマンド内で問合せを直接コールするサンプル:

oci opsi
opsi-data-objects query-data-templatized-query 
--compartment-id <compartment id>
--data-object-identifier <data object id>
--query-select-list '["DB_DISPLAY_NAME, CDB_NAME,EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC"]'
--query-order-by-list '["ROLLUP_TIME_UTC ASC"]'
--limit 1000

Oracle Cloud Infrastructureドキュメント

SQL問合せの保存、共有およびエクスポート