メインコンテンツまでスキップ

queries-legacy コマンド グループ

注記

この情報は、Databricks CLI バージョン 0.205 以降に適用されます。Databricks CLI は パブリック プレビュー段階です。

Databricks CLI 使用には、使用状況データを含む Databricks ライセンス および Databricks プライバシー通知が適用されます。

注記

Databricks SQL API の新しいバージョンが利用可能になりました。「 最新の Databricks SQL API バージョンに更新する」を参照してください。新しい Databricks SQL クエリに対して操作を実行するには、「コマンド グループqueries」を参照してください。

Databricks CLI 内の queries-legacy コマンド グループを使用すると、レガシ クエリ定義に対して取得、作成、更新、削除の操作を実行できます。

databricks queries-legacy create

新しいクエリ定義を作成します。このエンドポイントで作成されたクエリは、要求を行う認証されたユーザーに属します。

data_source_id フィールドは、このクエリを実行する SQLウェアハウスの ID を指定します。データソース コマンドを使用して、利用可能なSQLウェアハウスの完全なリストを表示できます。または、既存のクエリから data_source_id をコピーすることもできます。

注記

クエリを作成するまで、視覚化を追加することはできません。

databricks queries-legacy create [flags]

オプション

--json JSON

インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。

グローバルフラグ

databricks queries-legacy delete

クエリをゴミ箱に移動します。ごみ箱に入れられたクエリは、検索ビューとリストビューからすぐに消え、アラートに使用できません。ゴミ箱は 30 日後に削除されます。

databricks queries-legacy delete QUERY_ID [flags]

引数

QUERY_ID

削除するクエリの ID

オプション

グローバルフラグ

databricks queries-legacy get

クエリオブジェクト定義と、現在認証されているユーザーに関するコンテキスト権限情報を取得します。

databricks queries-legacy get QUERY_ID [flags]

引数

QUERY_ID

取得するクエリの ID

オプション

グローバルフラグ

databricks queries-legacy list

クエリのリストを取得します。オプションで、このリストを検索語でフィルタリングできます。

important

このコマンドを同時に 10 回以上実行すると、スロットリング、サービスの低下、または一時的な禁止が発生する可能性があります。

databricks queries-legacy list [flags]

オプション

--order string

順序付けするクエリ属性の名前。

--page int

取得するページ番号。

--page-size int

ページごとに返されるクエリの数。

--q string

全文検索語。

グローバルフラグ

databricks queries-legacy restore

ごみ箱に移動されたクエリを復元します。復元されたクエリは、リスト ビューと検索に表示されます。リストアされたクエリは、アラートに使用できます。

databricks queries-legacy restore QUERY_ID [flags]

引数

QUERY_ID

復元するクエリの ID

オプション

グローバルフラグ

databricks queries-legacy update

クエリ定義を変更します。

注記

この操作を元に戻すことはできません。

databricks queries-legacy update QUERY_ID [flags]

引数

QUERY_ID

更新するクエリの ID

オプション

--data-source-id string

データソース ID は、リソースで使用されるデータソースの ID にマッピングされ、ウェアハウス ID とは異なります。

--description string

使用上の注意など、このクエリに関する追加情報を伝える一般的な説明。

--json JSON

インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。

--name string

リストビュー、ウィジェット見出し、およびクエリページに表示されるこのクエリのタイトル。

--query string

実行するクエリのテキスト。

--run-as-role RunAsRole

オブジェクトの 「実行」 ロールを設定します。サポートされている値: ownerviewer

グローバルフラグ

グローバルフラグ

--debug

デバッグログを有効にするかどうか。

-h または --help

Databricks CLI、関連するコマンド グループ、または関連するコマンドのヘルプを表示します。

--log-file string

出力ログの書き込み先となるファイルを表す文字列。このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。

--log-format format

ログ・フォーマット・タイプ ( text または json) 。デフォルト値は textです。

--log-level string

ログ形式レベルを表す文字列。指定しない場合、ログ・フォーマット・レベルは使用不可になります。

-o, --output タイプ

コマンド出力タイプ text または json。デフォルト値は textです。

-p, --profile string

コマンドの実行に使用する ~/.databrickscfg ファイル内のプロファイルの名前。このフラグが指定されていない場合、存在する場合は、 DEFAULT という名前のプロファイルが使用されます。

--progress-format format

進行状況ログを表示する形式: defaultappendinplacejson

-t, --target string

該当する場合は、使用するバンドル・ターゲット