ここでは、プロジェクトに移動して、プロジェクトスペースのプロパティを設定する方法を紹介します (権限、ホワイトリストなど)。
ワークスペースへの移動
コマンド形式:
use <project_name>;コマンド動作:
- 特定のワークスペースに移動します。 ワークスペースに移動すると、そのワークスペース内にあるすべてのオブジェクトを操作できるようになります。
- ワークスペースが存在しない、あるいはワークスペースに属するユーザーがいない場合は、例外が返されます。
例：
odps:my_project>use my_project; --my_project is a workspce the user has privilege to access.注
上記例は、MaxCompute クライアントで実行しています。 すべての MaxCompute コマンド、キーワード、ワークスペース名、テーブル名、列名は、大文字小文字が区別されません。
プロジェクトを作成すると、MaxCompute プロジェクトも同時に作成されます。
このコマンドを実行すると、指定したワークスペース内にあるすべてのオブジェクトにアクセスできるようになります。 以下の例では、「my_project」 プロジェクトに
test_src というテーブルが存在するとします。 次のコマンドを実行します。
odps:my_project>select * from test_src;MaxCompute では、自動的に my_project 内のテーブルが検索されます。 指定したテーブルが存在する場合は、テーブルのデータが返されます。 指定したテーブルが存在しない場合、例外が返されます。
「my_project」プロジェクトから「my_project2」といった別のプロジェクトのテーブル test_src にアクセスするには、次のようにテーブルの前にプロジェクト名を指定する必要があります。
odps:my_project>select * from my_project2.test_src;最初の例に出てくる my_project プロジェクト内にある test_src テーブルのデータではなく、my_project2 プロジェクト内のデータが返されます。
MaxCompute には、ワークスペースを作成および削除するためのコマンドがありません。必要に応じて、MaxCompute コンソールを使用して、多くの設定と操作を実行できます。詳細は、「プロジェクトリスト (project list)」をご参照ください。
SetProject コマンド
コマンド形式:
setproject [<KEY>=<VALUE>];コマンド動作:
- プロジェクトの属性を設定するには、setproject コマンドを使用します。
以下の例では、フルテーブルスキャンの方法を設定します。
setproject odps.sql.allow.fullscan = true; - <KEY>=<VALUE> の値を指定しない場合、現行ワークスペース属性の設定が表示されます。 コマンド形式:
setproject; --Display the parameters set by the setproject command.
パラメーター
| プロパティ名 | 権限所有者 | 説明 | 値の範囲 |
|---|---|---|---|
| odps.sql.allow.fullscan | プロジェクトオーナー | フル テーブル スキャンを許可するかどうかを指定します。 | True (許可) /false (禁止) |
| odps.table.drop.ignorenonexistent | 全ユーザー | 存在しないテーブルを削除しようとしたとき、エラーを報告するかどうかを指定します。 「True」を指定すると、エラーは報告されません。 | True (エラーを報告しない)/false |
| odps.security.ip.whitelist | プロジェクトオーナー | プロジェクトへのアクセスを許可する IP ホワイトリストを指定します。 | IP リストはカンマ (,) で区切って指定します。 |
| odps.instance.remain.days | プロジェクトオーナー | インスタンス情報の保持期間を指定します。 | 3～30 |
| READ_TABLE_MAX_ROW | プロジェクトオーナー | クライアントから Select 文が実行されたときに返すデータ数を指定します。 | 1～10000 |
odps.security.ip.ホワイトリストの例
MaxCompute では、ワークスペースレベルで IP ホワイトリストを設定できます。
注
- IP ホワイトリストを設定すると、ホワイトリスト内の IP (コンソール IP または SDK が格納されている exit の IP) のみが、対応するワークスペースにアクセスできます。
- IP ホワイトリストを設定してから、変更が反映されるまで、少なくとも 5 分待つ必要があります。
- サポートが必要な場合には、チケットを起票し、サポート センターへお問い合わせください。
同一コマンド内で使用できるホワイトリストの IP 形式は､次の 3 通りあります。 これらのコマンドは、カンマ (,) で区切ります。
- IP アドレス: 例101.132.236.134
- サブネットマスク: 例 100.116.0.0/16
- ネットワークセグメント: 例 101.132.236.134-101.132.236.144
IP ホワイトリストを設定するためのコマンドラインツールの例は、次の通りです。
setproject odps.security.ip.whitelist=101.132.236.134,100.116.0.0/16,101.132.236.134-101.132.236.144;ホワイトリストに IP アドレスが 1 つも追加されていない場合、ホワイトリスト機能は無効になります。
setproject odps.security.ip.whitelist=;