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
クエリのリストを取得します。オプションで、このリストを検索語でフィルタリングできます。
このコマンドを同時に 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
オブジェクトの 「実行」 ロールを設定します。サポートされている値: owner
、 viewer
グローバルフラグ
--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
進行状況ログを表示する形式: default
、 append
、 inplace
、 json
-t, --target
string
該当する場合は、使用するバンドル・ターゲット