MaxCompute内部テーブル、ビュー、マテリアライズドビュー、外部テーブル、クラスタ化テーブル、またはトランザクションテーブルに関する情報を表示します。
構文
-- View the information about an internal table or a view.
desc <table_name|view_name> [partition (<pt_spec>)];
-- View the information about a materialized view, an external table, a clustered table, or a transactional table. You can also execute this statement to view extended information about an internal table.
desc extended <table_name|mv_name>; パラメーター
table_name: 必須です。 情報を表示するテーブルの名前。
view_name: 必須です。 情報を表示するビューの名前。
mv_name: 情報を表示するマテリアライズドビューの名前。
pt_spec: オプション。 情報を表示するテーブルパーティション。 このパラメーターの値は、
(partition_col1 = partition_col_value1, partition_col2 = partition_col_value2, ...)形式です。extended: このパラメーターは、マテリアライズドビュー、外部テーブル、クラスター化テーブル、またはトランザクションテーブルに関する情報を表示する場合に必要です。 このパラメーターは、テーブルに関する拡張情報を表示するために使用されます。 このパラメーターを使用して、内部テーブルの列にnull値を含めることができるかどうかなど、内部テーブルに関する拡張情報を表示することもできます。
戻り値
Owner: テーブルまたはビューの所有者。
Project: テーブルまたはビューが属するプロジェクト。
TableComment: テーブルまたはビューのコメント。
CreateTime: テーブルまたはビューが作成された時刻。
LastDDLTime: テーブルまたはビューのデータ定義言語 (DDL) ステートメントが最後に変更された時刻。
LastModifiedTime: テーブルまたはビューのデータが最後に変更された時刻。
Lifecycle: 日単位のライフサイクル。
InternalTable: オブジェクトが内部テーブルかどうかを示します。 このパラメーターは、テーブルに対してのみ返されます。
VirtualView: オブジェクトがビューかどうかを示します。 このパラメーターはビューに対してのみ返されます。
Size: テーブルのサイズ。 単位はバイトです。
Native Columns: テーブルまたはビューの列情報。
Partition Columns: パーティションキー列に関する情報。 このパラメーターは、パーティション分割テーブルに対してのみ返されます。
例
例1: test1テーブルに関する情報を表示します。 例：
desc test1;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$maoXXX@alibaba-inc.com | Project: $project_name | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2020-11-16 17:47:48 | | LastDDLTime: 2020-11-16 17:47:48 | | LastModifiedTime: 2020-11-16 17:47:48 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | Comment | +------------------------------------------------------------------------------------+ | key | string | | | +------------------------------------------------------------------------------------+例2: sale_detailテーブルに関する情報を表示します。 例：
desc sale_detail;次の応答が返されます。
+--------------------------------------------------------------------+ | Owner: ALIYUN$maoXXX@alibaba-inc.com | Project: $project_name | | TableComment: | +--------------------------------------------------------------------+ | CreateTime: 2017-06-28 15:05:17 | | LastDDLTime: 2017-06-28 15:05:17 | | LastModifiedTime: 2017-06-28 15:05:17 | +--------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +--------------------------------------------------------------------+ | Native Columns: | +--------------------------------------------------------------------+ | Field | Type | Label | Comment | +--------------------------------------------------------------------+ | shop_name | string | | | | customer_id | string | | | | total_price | double | | | +--------------------------------------------------------------------+ | Partition Columns: | +--------------------------------------------------------------------+ | sale_date | string | | | region | string | | +--------------------------------------------------------------------+例3: sale_detail_ctas1テーブルに関する詳細情報を表示します。 例：
desc extended sale_detail_ctas1;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$maoXXX@alibaba-inc.com | Project: $project_name | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2021-07-07 15:29:53 | | LastDDLTime: 2021-07-07 15:29:53 | | LastModifiedTime: 2021-07-07 15:29:53 | | Lifecycle: 10 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | ExtendedLabel | Nullable | DefaultValue | Comment | +------------------------------------------------------------------------------------+ | shop_name | string | | | true | NULL | | | customer_id | string | | | true | NULL | | | total_price | double | | | true | NULL | | | sale_date | string | | | true | NULL | | | region | string | | | true | NULL | | +------------------------------------------------------------------------------------+ | Extended Info: | +------------------------------------------------------------------------------------+ | TableID: 98cb8a38733c49eabed4735173818147 | | IsArchived: false | | PhysicalSize: 0 | | FileNum: 0 | | StoredAs: AliOrc | | CompressionStrategy: normal | +------------------------------------------------------------------------------------+sale_date列とregion列は共通列と見なされます。 パーティションキー列ではありません。
例4: sale_detail_ctas2テーブルに関する情報を表示します。 例：
desc sale_detail_ctas2;次の応答が返されます。
+--------------------------------------------------------------------+ | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name | | TableComment: | +--------------------------------------------------------------------+ | CreateTime: 2017-06-28 15:42:17 | | LastDDLTime: 2017-06-28 15:42:17 | | LastModifiedTime: 2017-06-28 15:42:17 | +--------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +--------------------------------------------------------------------+ | Native Columns: | +--------------------------------------------------------------------+ | Field | Type | Label | Comment | +--------------------------------------------------------------------+ | shop_name | string | | | | customer_id | string | | | | total_price | double | | | | sale_date | string | | | | region | string | | | +--------------------------------------------------------------------+例5: sale_detail_likeテーブルの詳細を表示します。 例：
desc extended sale_detail_like;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2021-07-07 15:40:38 | | LastDDLTime: 2021-07-07 15:40:38 | | LastModifiedTime: 2021-07-07 15:40:38 | | Lifecycle: 10 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | ExtendedLabel | Nullable | DefaultValue | Comment | +------------------------------------------------------------------------------------+ | shop_name | string | | | true | NULL | | | customer_id | string | | | true | NULL | | | total_price | double | | | true | NULL | | +------------------------------------------------------------------------------------+ | Partition Columns: | +------------------------------------------------------------------------------------+ | sale_date | string | | | region | string | | +------------------------------------------------------------------------------------+ | Extended Info: | +------------------------------------------------------------------------------------+ | TableID: 61782ff7713f426e9d6f91d5deeac99a | | IsArchived: false | | PhysicalSize: 0 | | FileNum: 0 | | StoredAs: AliOrc | | CompressionStrategy: normal | +------------------------------------------------------------------------------------+ライフサイクル設定を除いて、sale_detail_likeテーブルのすべてのプロパティ (フィールドタイプやパーティションタイプなど) は、sale_detailテーブルのプロパティと同じです。
説明DESC table_nameステートメントの出力のデータサイズには、ごみ箱のデータサイズが含まれます。 ごみ箱をクリアする場合は、PURGE TABLE table_nameステートメントを実行します。 次に、DESC table_nameステートメントを実行して、ごみ箱内のデータのサイズを除くデータのサイズを表示します。SHOW RECYCLEBINステートメントを実行して、プロジェクトのごみ箱内のデータに関する詳細を表示することもできます。例6: test_newtypeテーブルに関する情報を表示します。 例：
desc test_newtype;次の応答が返されます。
| Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | Comment | +------------------------------------------------------------------------------------+ | c1 | tinyint | | | | c2 | smallint | | | | c3 | int | | | | c4 | bigint | | | | c5 | float | | | | c6 | double | | | | c7 | decimal | | | | c8 | binary | | | | c9 | timestamp | | | | c10 | array<map<bigint,bigint>> | | | | c11 | map<string,array<bigint>> | | | | c12 | struct<s1:string,s2:bigint> | | | | c13 | varchar(20) | | | +------------------------------------------------------------------------------------+ OK例7: ハッシュクラスタ化テーブルt1に関する情報を表示します。 このテーブルはパーティション分割されていないテーブルです。 クラスタリング属性は拡張情報に表示されます。 例：
desc extended t1;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2020-11-16 18:00:56 | | LastDDLTime: 2020-11-16 18:00:56 | | LastModifiedTime: 2020-11-16 18:00:56 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | ExtendedLabel | Nullable | DefaultValue | Comment | +------------------------------------------------------------------------------------+ | a | string | | | true | NULL | | | b | string | | | true | NULL | | | c | bigint | | | true | NULL | | +------------------------------------------------------------------------------------+ | Extended Info: | +------------------------------------------------------------------------------------+ | TableID: e6b06f705dc34a36a5b72e5af486cab7 | | IsArchived: false | | PhysicalSize: 0 | | FileNum: 0 | | StoredAs: AliOrc | | CompressionStrategy: normal | | ClusterType: hash | | BucketNum: 1024 | | ClusterColumns: [c] | | SortColumns: [c ASC] | +------------------------------------------------------------------------------------+ OK例8: ハッシュクラスタ化テーブルt2に関する情報を表示します。 このテーブルはパーティションテーブルです。 クラスタリング属性は拡張情報に表示されます。 例：
desc extended t2;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2017-12-25 11:18:26 | | LastDDLTime: 2017-12-25 11:18:26 | | LastModifiedTime: 2017-12-25 11:18:26 | | Lifecycle: 2 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | Comment | +------------------------------------------------------------------------------------+ | a | string | | | | b | string | | | | c | bigint | | | +------------------------------------------------------------------------------------+ | Partition Columns: | +------------------------------------------------------------------------------------+ | dt | string | | +------------------------------------------------------------------------------------+ | Extended Info: | +------------------------------------------------------------------------------------+ | TableID: 91a3395d3ef64b4d9ee1d2852755 | | IsArchived: false | | PhysicalSize: 0 | | FileNum: 0 | | ClusterType: hash | | BucketNum: 1024 | | ClusterColumns: [c] | | SortColumns: [c ASC] | +------------------------------------------------------------------------------------+ OK例9: 範囲クラスタ化テーブルt3に関する情報を表示します。 このテーブルはパーティション分割されていないテーブルです。 クラスタリング属性は拡張情報に表示されます。 例：
desc extended t3;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2020-11-16 18:01:05 | | LastDDLTime: 2020-11-16 18:01:05 | | LastModifiedTime: 2020-11-16 18:01:05 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | ExtendedLabel | Nullable | DefaultValue | Comment | +------------------------------------------------------------------------------------+ | a | string | | | true | NULL | | | b | string | | | true | NULL | | | c | bigint | | | true | NULL | | +------------------------------------------------------------------------------------+ | Extended Info: | +------------------------------------------------------------------------------------+ | TableID: 38d170aca2684f4baadbbe1931a6ae1f | | IsArchived: false | | PhysicalSize: 0 | | FileNum: 0 | | StoredAs: AliOrc | | CompressionStrategy: normal | | ClusterType: range | | BucketNum: 1024 | | ClusterColumns: [c] | | SortColumns: [c ASC] | +------------------------------------------------------------------------------------+ OK例10: 範囲クラスタ化テーブルt4に関する情報を表示します。 このテーブルはパーティションテーブルです。 クラスタリング属性は拡張情報に表示されます。 例：
desc extended t4;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2020-11-16 19:17:48 | | LastDDLTime: 2020-11-16 19:17:48 | | LastModifiedTime: 2020-11-16 19:17:48 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | ExtendedLabel | Nullable | DefaultValue | Comment | +------------------------------------------------------------------------------------+ | a | string | | | true | NULL | | | b | string | | | true | NULL | | | c | bigint | | | true | NULL | | +------------------------------------------------------------------------------------+ | Partition Columns: | +------------------------------------------------------------------------------------+ | dt | string | | +------------------------------------------------------------------------------------+ | Extended Info: | +------------------------------------------------------------------------------------+ | TableID: 6ebc3432e283449188c861427bcd6ee4 | | IsArchived: false | | PhysicalSize: 0 | | FileNum: 0 | | StoredAs: AliOrc | | CompressionStrategy: normal | | ClusterType: range | | BucketNum: 0 | | ClusterColumns: [c] | | SortColumns: [c ASC] | +------------------------------------------------------------------------------------+ OK例11: 非パーティションテーブルt5がトランザクションテーブルであるかどうかを確認します。 例：
説明MaxComputeクライアントを使用して、テーブルがトランザクションテーブルであるかどうかを確認することを推奨します。 MaxComputeクライアントのバージョンはV0.35.4である必要があります。 MaxComputeクライアントをダウンロードして使用する方法の詳細については、「MaxComputeクライアント」をご参照ください。 他のツールは、トランザクション情報を表示するように更新されない。
desc extended t5;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$xxxxx@aliyun.com | Project: $project_name | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2021-02-18 10:56:27 | | LastDDLTime: 2021-02-18 10:56:27 | | LastModifiedTime: 2021-02-18 10:56:27 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | ExtendedLabel | Nullable | DefaultValue | Comment | +------------------------------------------------------------------------------------+ | id | bigint | | | true | NULL | | +------------------------------------------------------------------------------------+ | Extended Info: | +------------------------------------------------------------------------------------+ ... | Transactional: true | +------------------------------------------------------------------------------------+例12: 分割テーブルt6がトランザクションテーブルであるかどうかをチェックする。 例：
説明MaxComputeクライアントを使用して、テーブルがトランザクションテーブルであるかどうかを確認することを推奨します。 MaxComputeクライアントのバージョンはV0.35.4である必要があります。 MaxComputeクライアントをダウンロードして使用する方法の詳細については、「MaxComputeクライアント」をご参照ください。 他のツールは、トランザクション情報を表示するように更新されない。
desc extended t6;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$xxxxx@test.aliyunid.com | Project: $project_name | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2021-02-18 15:34:54 | | LastDDLTime: 2021-02-18 15:34:54 | | LastModifiedTime: 2021-02-18 15:34:54 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | Comment | +------------------------------------------------------------------------------------+ | id | bigint | | | +------------------------------------------------------------------------------------+ | Partition Columns: | +------------------------------------------------------------------------------------+ | ds | string | | +------------------------------------------------------------------------------------+ | Extended Info: | +------------------------------------------------------------------------------------+ ... | Transactional: true | +------------------------------------------------------------------------------------+例13: マテリアライズドビューmvに関する情報を表示する。
desc extended mv;次の応答が返されます。
+------------------------------------------------------------------------------------+ | Owner: ALIYUN$****@aliyunid.com | Project: **** | | TableComment: | +------------------------------------------------------------------------------------+ | CreateTime: 2021-08-01 17:50:15 | | LastDDLTime: 2021-08-01 17:50:15 | | LastModifiedTime: 2021-08-01 17:50:15 | +------------------------------------------------------------------------------------+ | InternalTable: YES | Size: 0 | +------------------------------------------------------------------------------------+ | Native Columns: | +------------------------------------------------------------------------------------+ | Field | Type | Label | ExtendedLabel | Nullable | DefaultValue | Comment | +------------------------------------------------------------------------------------+ | page_id | string | | | true | NULL | | | _c1 | bigint | | | true | NULL | | +------------------------------------------------------------------------------------+ | Extended Info: | +------------------------------------------------------------------------------------+ | TableID: e4a7f1169588400ab39bc3076426**** | | IsArchived: false | | PhysicalSize: 0 | | FileNum: 0 | +------------------------------------------------------------------------------------+例14: パーティションテーブルsale_detailに関するパーティション情報を表示します。
desc sale_detail partition (sale_date='201310',region='beijing');次の応答が返されます。
+------------------------------------------------------------------------------------+ | PartitionSize: 2109112 | +------------------------------------------------------------------------------------+ | CreateTime: 2015-10-10 08:48:48 | | LastDDLTime: 2015-10-10 08:48:48 | | LastModifiedTime: 2015-10-11 01:33:35 | +------------------------------------------------------------------------------------+ OK
関連ステートメント
CREATE TABLE: 非パーティションテーブル、パーティションテーブル、外部テーブル、またはクラスタ化テーブルを作成します。
CREATE VIEW: クエリ文に基づいてビューを作成するか、既存のビューを更新します。
マテリアライズドビューの作成: マテリアライズドビューのシナリオのデータに基づいて、クラスタリングとパーティション分割をサポートするマテリアライズドビューを作成します。
ALTER MATERIALIZED VIEW: マテリアライズドビューを更新し、マテリアライズドビューのライフサイクルを変更し、マテリアライズドビューのライフサイクルを有効または無効にし、マテリアライズドビューのパーティションを削除します。
SELECT MATERIALIZED VIEW: マテリアライズドビューのステータスを照会します。
DROP MATERIALIZED VIEW: 既存のマテリアライズドビューを削除します。