📣新登場!TiDB Cloud BYOC、TiDB Cloud Filesystem、PostgreSQL-compatible TiDB Cloud Starter がパブリックプレビュー中。このページは自動翻訳されたものです。原文はこちらからご覧ください。

Warehouse



TiDB Cloud Lake の Warehouse 関連 SQL コマンド。

一般ルール

  • Warehouse の命名: 3~63 文字で、使用できるのは A-Z、a-z、0-9、- のみです。
  • 文字列と識別子: スペースを含まない場合、裸の識別子では引用符を省略できます。それ以外の場合は、単一引用符で囲みます。文法上はキーワードや数値/ブールリテラルを名前として使用できますが、実行時の検証は引き続き適用されます。
  • 数値パラメータ: nullable_unsigned_number / nullable_signed_number は整数または NULL を受け付けます。NULL を指定すると値がリセットされます(たとえば、AUTO_SUSPEND = NULL は 0 と同じです)。
  • 時間パラメータ: QUERY_HISTORY は YYYY-MM-DD HH:MM:SS(UTC または明示的なタイムゾーン)を使用します。小数秒が省略された場合は、秒単位の値として解釈されます。
  • ブールパラメータ: TRUE/FALSE のみ受け付けます。
  • WITH キーワード: オプションリスト全体の前、または各オプションの前に指定できます。オプションは空白で区切られ、カンマは文法の一部ではありません。

Warehouse 管理

タグは、AWS リソースタグと同様に、Warehouse の分類や整理に役立つキーと値のペアです。一般的に、次の用途で使用されます。

  • コスト配分: チーム、プロジェクト、またはコストセンターごとに Warehouse のコストを追跡する
  • 環境の識別: Warehouse を dev、staging、または production としてマークする
  • チーム所有権: どのチームが Warehouse を所有または管理しているかを識別する
  • カスタムメタデータ: 組織上の目的のために任意のメタデータを追加する

タグのキーと値は任意の文字列です(スペースや特殊文字を含む場合は引用符で囲みます)。タグは次のように扱えます。

  • WITH TAG (key = 'value', ...) を使用して Warehouse 作成時に追加する
  • ALTER WAREHOUSE ... SET TAG key = 'value' を使用して後から更新または追加する
  • ALTER WAREHOUSE ... UNSET TAG key を使用して削除する

タグは API レスポンスで返され、SHOW WAREHOUSES でも確認できます。

タグの制限:

  • 1 つの Warehouse あたり最大 10 個のタグ
  • タグ名(キー)の最大長: 128 文字
  • タグ値の最大長: 256 文字

サポートされるステートメント

ステートメント目的注記
CREATE WAREHOUSEWarehouse を作成IF NOT EXISTS とオプションリストをサポート
ALTER WAREHOUSE一時停止/再開/変更/名前変更SUSPEND/RESUME、SET <options>、または RENAME TO <name>
DROP WAREHOUSEWarehouse を削除IF EXISTS は省略可能
USE WAREHOUSE現在のセッションにバインド存在確認のみを行います
SHOW WAREHOUSESWarehouse を一覧表示LIKE フィルタは省略可能
QUERY_HISTORYクエリログを確認Warehouse、時間範囲、件数制限でフィルタ可能

Warehouse SQL コマンド

コマンド説明
CREATE WAREHOUSE新しい Warehouse を作成します
USE WAREHOUSEセッションの現在の Warehouse を設定します
SHOW WAREHOUSESオプションのフィルタ付きですべての Warehouse を一覧表示します
ALTER WAREHOUSEWarehouse の一時停止、再開、または設定変更を行います
ALTER WAREHOUSE ASSIGN NODESWarehouse クラスターにノードを割り当てます
ALTER WAREHOUSE UNASSIGN NODESWarehouse クラスターから割り当て済みノードを削除します
DROP WAREHOUSEWarehouse を削除します
QUERY_HISTORYWarehouse のクエリログを確認します

このページは役に立ちましたか?