MaxCompute SQL を使用すると、プロジェクト、テーブル、リソース、インスタンス、関数、トンネル、外部ボリュームなど、すべてのコアオブジェクトを統一されたコマンドセットで管理できます。このページでは、これらのコマンドをオブジェクトタイプ別にグループ化しているため、必要な文をすばやく見つけ、その完全な構文リファレンスにジャンプできます。
ここに記載されていない文については、「すべての文 (アルファベット順)」または「関数リファレンス」をご参照ください。
MaxCompute SQL のキーワード、プロジェクト名、テーブル名、列名では、大文字と小文字は区別されません。これらの操作をプログラムで実行するには、「MaxCompute SDK」をご参照ください。
文のリファレンス
プロジェクト操作
プロジェクトは MaxCompute の最上位の名前空間です。これらのコマンドを使用して、プロジェクトの切り替え、プロジェクトプロパティの検査または変更、プロジェクトに関連付けられたアカウントシステム (RAM) の管理を行います。
| 文 | 説明 |
|---|---|
| use | プロジェクトに切り替える |
| setproject (表示) | プロジェクトのプロパティを表示する |
| setproject (設定) | プロジェクトプロパティを設定する |
| list accountproviders | プロジェクトのアカウントシステムを表示する |
| add | RAM アカウントシステムを追加する |
| remove | RAM アカウントシステムを削除する |
SET 操作
SET と SHOW FLAGS を使用して、MaxCompute セッション内でセッションレベルのフラグを設定し、現在の値を検査します。
| 文 | 説明 |
|---|---|
| SET | セッションレベルのフラグを設定する |
| SHOW FLAGS | 現在のセッションフラグの値を表示する |
セキュリティ操作
これらのコマンドは、データ保護とプロジェクト間の信頼を制御します。通常、プロジェクト管理者によって実行されます。これらを使用して、プロジェクトレベルのデータ保護を有効にし、保護されたデータへのアクセスが許可されている信頼できるプロジェクトを管理し、プロジェクトのセキュリティ構成を検査します。
| 文 | 説明 |
|---|---|
| ProjectProtection | プロジェクトのデータ保護を有効にする |
| add trustedproject | 信頼できるプロジェクトを追加する |
| remove trustedproject | 信頼できるプロジェクトを削除する |
| list trustedprojects | 信頼できるプロジェクトを表示する |
| show SecurityConfiguration | プロジェクトのセキュリティ構成を表示する |
ユーザーとロールの操作
これらのコマンドを使用して、プロジェクトにユーザーを追加または削除したり、ロールを作成および削除したり、ユーザーにロールを割り当てたりします。ロールは権限をグループ化します。ユーザーにロールを付与すると、そのロールに関連付けられているすべての権限がユーザーに与えられます。
| 文 | 説明 |
|---|---|
| add user | プロジェクトにユーザーを追加する |
| remove user | プロジェクトからユーザーを削除する |
| list users | プロジェクト内のすべてのユーザーを表示する |
| create role | ロールを作成する |
| list roles | プロジェクト内のすべてのロールを表示する |
| grant | ユーザーにロールを割り当てる |
| revoke | ロールからユーザーを削除する |
| drop role | ロールを削除する |
認可操作
grant と revoke を使用して、プロジェクト内の特定のリソースにアクセスできるユーザーまたはロールを制御します。
| 文 | 説明 |
|---|---|
| grant | ロールまたはユーザーに権限を付与する |
| revoke | ロールまたはユーザーから権限を取り消す |
テーブル操作
これらは MaxCompute で最も頻繁に使用されるコマンドです。テーブルとビューのライフサイクル全体 (テーブル、パーティション、ビューの作成、所有権の変更、削除、検査) をカバーします。
| 文 | 説明 |
|---|---|
| create table | テーブルを作成する |
| alter table | テーブルの所有者を変更する |
| drop table | テーブルを削除する |
| desc | テーブルまたはビューに関する情報を表示する |
| desc partition | パーティション情報を表示する |
| show tables | プロジェクト内のテーブルとビューをリスト表示する |
| show partitions | テーブルのパーティションをリスト表示する |
インスタンス操作
インスタンスは、MaxCompute で実行中または完了したジョブを表します。これらのコマンドを使用して、ジョブステータスの監視、ジョブ詳細とログの検査、実行中のジョブの停止を行います。
| 文 | 説明 |
|---|---|
| show | インスタンス情報を表示する |
| status | インスタンスのステータスを照会する |
| top instance | 現在実行中のすべてのインスタンスを表示する |
| kill | 実行中のインスタンスを停止する |
| desc | インスタンスのジョブ情報を取得する |
| wait | インスタンス内のジョブの運用ログを取得する |
リソース操作
リソースは、ユーザー定義関数 (UDF) やその他のジョブが依存するファイル (JAR パッケージ、テキストファイル、アーカイブなど) です。これらのコマンドを使用して、リソースの追加、検査、ダウンロード、エイリアスの作成、削除を行います。
| 文 | 説明 |
|---|---|
| add | リソースを追加する |
| リソース情報の表示 | リソース情報を表示する |
| リソースリストの表示 | リソースリストを表示する |
| alias | リソースのエイリアスを作成する |
| get | リソースをダウンロードする |
| drop | リソースを削除する |
外部ボリューム操作
| 文 | 説明 |
|---|---|
| 外部ボリュームの作成 | 外部ボリュームを作成する |
| 外部ボリュームのリスト表示 | 外部ボリュームのリストと外部ボリュームのディレクトリ構造を表示する |
| 外部ボリュームの削除 | 外部ボリュームを削除する |
関数操作
これらのコマンドは、独自のロジックで MaxCompute SQL を拡張するカスタム関数であるユーザー定義関数 (UDF) を管理します。これらを使用して、UDF の登録、削除、検査、および MaxCompute で利用可能なすべてのビルトイン関数の表示を行います。
| 文 | 説明 |
|---|---|
| create function | UDF を作成する |
| drop function | UDF を削除する |
| UDF リストの表示 | UDF リストを表示する |
| すべてのビルトイン関数の表示 | すべてのビルトイン関数を表示する |
トンネル操作
トンネルは MaxCompute の一括データ転送ツールです。これを使用して、高スループットで MaxCompute テーブルにデータをアップロードしたり、テーブルからデータをダウンロードしたりします。
| 文 | 説明 |
|---|---|
| トンネルアップロード | MaxCompute にデータをアップロードする |
| トンネルダウンロード | MaxCompute からデータをダウンロードする |
タイムゾーン設定操作
MaxCompute のジョブとセッションのタイムゾーンを設定するコマンドについては、「タイムゾーン設定操作」をご参照ください。
その他の操作
| 文 | 説明 |
|---|---|
| cost sql | SQL 文を実行する前に、そのコストを見積もります |
次のステップ
-
すべての文 (アルファベット順) — すべての MaxCompute SQL 文の完全なアルファベット順インデックス
-
関数リファレンス — カテゴリ別にグループ化されたビルトイン関数
-
MaxCompute SDK — これらの操作をプログラムで実行する