MaxCompute:スキーマ関連の操作

スキーマ構文スイッチ

スキーマ構文スイッチは、ドット区切りの識別子の解析方法を制御します。

制御には、以下の 2 つのレベルがあります。

• テナントレベルの設定：テナントが送信するすべてのジョブに対するデフォルトの解析動作を設定します。

• ジョブレベルの設定：現在のジョブのみに対して、テナントレベルの設定をオーバーライドします。ジョブの先頭で set odps.namespace.schema=true; または set odps.namespace.schema=false; を実行します。

あるモードで作成されたビューおよび UDF は、同一のモードでのみアクセス可能です。同一のオブジェクトに対してモードを混在させることはサポートされていません。

新規テナント（既存のプロジェクトがない場合）

適用タイミング：テナントにまだプロジェクトが存在しない場合。

1. MaxCompute コンソールにログインし、リージョンを選択します。MaxCompute コンソールMaxCompute コンソール

2. 左側のナビゲーションウィンドウで、構成の管理 > テナント を選択します。

3. テナント ページで、テナントプロパティ タブをクリックします。

4. テナントレベルのスキーマ構文 スイッチをオンにします。

この設定以降に作成されるすべての新規プロジェクトは、デフォルトでスキーマをサポートし、odps.namespace.schema=true がデフォルトの解析動作になります。

小規模テナント（既存のジョブが少ない場合：プロジェクト数が 10 個以下）

適用タイミング：テナントに 10 個以下のプロジェクトがあり、既存のジョブがほとんどない、またはまったくない場合。

1. 既存の各プロジェクトをスキーマ対応へアップグレードします。

   1. 左側のナビゲーションウィンドウで、構成の管理 > プロジェクト を選択します。

   2. プロジェクト ページで、対象のプロジェクトを見つけ、操作 列の スキーマ対応へのアップグレード をクリックします。

   3. 各プロジェクトについて同様の操作を繰り返します。

2. テナントレベルのスキーマ構文を有効化します。

   1. 左側のナビゲーションウィンドウで、構成の管理 > テナント を選択します。

   2. テナント ページで、テナントプロパティ タブをクリックします。

   3. テナントレベルのスキーマ構文 スイッチをオンにします。

この設定後、すべての新規プロジェクトはスキーマをサポートし、リクエストはデフォルトで odps.namespace.schema=true で解析されます。

既存のプロジェクトおよびジョブがあるテナント（選択的アップグレード）

適用タイミング：テナントに既存のジョブがあり、グローバル設定を変更せずに特定のプロジェクトに対してのみスキーマを有効化したい場合。

1. 左側のナビゲーションウィンドウで、構成の管理 > プロジェクト を選択します。

2. プロジェクト ページで、対象のプロジェクトを見つけ、操作 列の スキーマ対応へのアップグレード をクリックします。

アップグレード後、プロジェクト内に DEFAULT スキーマが自動的に作成されます。ただし、テナントレベルでは引き続きデフォルトで odps.namespace.schema=false でリクエストが解析されます。アップグレード済みプロジェクト内のカスタムスキーマにアクセスするには、ジョブレベルでスキーマ構文を有効化します。

set odps.namespace.schema=true;

スキーマ構文が無効の場合、projectname.tablename は DEFAULT スキーマ内のテーブルのみに解決されます。カスタムスキーマ内のテーブルにアクセスするには、ジョブレベルでスキーマ構文を有効化してください。

未アップグレードのプロジェクト：スキーマ構文が有効化されている場合、データパスは projectname.default.tablename となります。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

• MaxCompute プロジェクトの作成

• プロジェクトでスキーマ対応が有効化されていること（「スキーマ機能の有効化」を参照）

必要な権限：スキーマ所有者は、デフォルトでスキーマおよびその内部のすべてのオブジェクトに対する完全なアクセス権およびアクセス制御権限を持ちます。スキーマの作成、説明、削除を行うには、適切なプロジェクトレベルの権限が必要です。

参照形式

現在のスキーマを設定するには、以下のコマンドを実行します。

use schema <schema_name>;

このコマンド実行後、修飾子なしのテーブル名は、現在のプロジェクト内の指定されたスキーマに解決されます。

リソースの参照形式

リソース（JAR ファイル、アーカイブ、その他のファイル）をスキーマ間またはプロジェクト間で参照する場合は、コロン (:) を区切り文字として使用します。

例

use projectA;
set odps.namespace.schema=true; -- テナントレベルで既に設定済みの場合は省略可能。

-- DEFAULT スキーマ内にテーブルを作成し、データを挿入します。
create table t_a(c1 string, c2 bigint);
INSERT OVERWRITE TABLE t_a VALUES ('a',1),('b',2),('c',3);
select * from t_a;
show tables;
desc t_a;

-- Tunnel を使用してデータをアップロードおよびダウンロードします。
tunnel upload <path> t_a[/<pt_spc>];
tunnel download t_a[/pt_spc] <path>;

-- DEFAULT スキーマ内のリソースを管理します。
add jar <path>/res_a.jar;
desc resource res_a.jar;
list resources;
get resource res_a.jar D:\;
drop resource res_a.jar;

-- DEFAULT スキーマ内の関数を管理します。
create function fun_a as 'xx' using 'res_a.jar';
desc function fun_a;
list functions;
drop function fun_a;

use projectA;
set odps.namespace.schema=true; -- テナントレベルで既に設定済みの場合は省略可能。

-- スキーマ s_1 に切り替えて、テーブル t_c を操作します。
use schema s_1;
create table t_c(c1 string, c2 bigint);
INSERT OVERWRITE TABLE t_c VALUES ('a',1),('b',2),('c',3);
select * from t_c;
show tables;
drop table t_c;

tunnel upload <path> t_c[/<pt_spc>];
tunnel download t_c[/pt_spc] <path>;

-- スキーマを切り替えずに、直接スキーマ s_2 内のテーブル t_d を参照します。
create table s_2.t_d(c1 string, c2 bigint);
insert into/overwrite table s_2.t_d values ('a',1),('b',2),('c',3);
select * from s_2.t_d;
show tables in s_2;
drop table s_2.t_d;

tunnel upload <path> s_2.t_d[/<pt_spc>];
tunnel download s_2.t_d[/pt_spc] <path>;

-- スキーマ s_1（現在のスキーマ）内のリソースを管理します。
use schema s_1;
add jar <path>/res_b.jar;
desc resource res_b.jar;
list resources;
get resource res_b.jar D:\;
drop resource res_b.jar;

-- コロン区切りでスキーマ s_2 内のリソースを参照します。
-- 注：リソースの追加は、対象のスキーマ内から実行する必要があります。
-- スキーマ間でリソースを追加するには、まず s_2 に切り替えてください。
desc resource s_2:res_c.jar;
list resources in s_2;
get resource s_2:res_c.jar D:\;
drop resource s_2:res_c.jar;

-- スキーマ s_1（現在のスキーマ）内の関数を管理します。
use schema s_1;
create function fun_b as 'xx' using 'res_b.jar';
desc function fun_b;
list functions;
drop function fun_b;

-- ドット表記でスキーマ s_2 内の関数を管理します。
create function s_2.fun_c as 'xx' using 's_2/resources/res_c.jar';
desc function s_2.fun_c;
list functions in s_2;
drop function s_2.fun_c;

use projectA;
set odps.namespace.schema=true; -- テナントレベルで既に設定済みの場合は省略可能。

-- プロジェクト B、スキーマ s_3 内にテーブル t_f を作成し、アクセスします。
create table projectB.s_3.t_f(c1 string, c2 bigint);
INSERT OVERWRITE TABLE projectB.s_3.t_f VALUES ('a',1),('b',2),('c',3);
select * from projectB.s_3.t_f;
show tables in projectB.s_3;
desc projectB.s_3.t_f;
drop table projectB.s_3.t_f;

tunnel upload <path> projectB.s_3.t_f[/<pt_spc>];
tunnel download projectB.s_3.t_f[/pt_spc] <path>;

-- コロン区切りでプロジェクト B、スキーマ s_3 内のリソースを参照します。
-- 注：リソースの追加は、対象のプロジェクトおよびスキーマ内から実行する必要があります。
-- 追加操作を実行する前に、プロジェクト B に切り替えてスキーマ s_3 を使用してください。
desc resource projectB:s_3:res_f.jar;
list resources in projectB.s_3;
get resource projectB:s_3:res_f.jar D:\;
drop resource projectB:s_3:res_f.jar;

-- プロジェクト B、スキーマ s_3 内の関数を管理します。
create function projectB.s_3.fun_f as 'xx' using 'projectB/schemas/s_3/resources/res_f.jar';
desc function projectB.s_3.fun_f;
list functions in projectB.s_3;
drop function projectB.s_3.fun_f;

スキーマ操作のプロジェクトレベル権限

テーブル、リソース、および関数の作成権限は、プロジェクトレベルで付与され、スキーマレベルではありません。プロジェクトに対して CreateTable、CreateResource、CreateFunction 権限を持っている場合、これらの権限は、そのプロジェクト内のすべてのスキーマに自動的に適用されます。

スキーマ所有者は、デフォルトでスキーマおよびその内部のすべてのオブジェクトに対する完全なアクセス権およびアクセス制御権限を持ちます。

スキーマレベルでの細かいアクセス制御は、今後のリリースで予定されています。

• スキーマオブジェクトに関連する権限は以下のとおりです。

  操作	オブジェクト	説明
  CreateSchema	プロジェクト	プロジェクト内にスキーマを作成する権限。
  Describe	スキーマ	スキーマを表示する権限。
  List	スキーマ	スキーマ内のリソースを一覧表示する権限。
  Drop	スキーマ	スキーマを削除する権限。
  Usage	スキーマ	現在のスキーマを切り替える権限。
  CreateTable	スキーマ	スキーマ内にテーブルを作成する権限。
  CreateResource	スキーマ	スキーマ内にリソースを作成する権限。
  CreateFunction	スキーマ	スキーマ内に関数を作成する権限。

• 権限付与の構文は以下のとおりです。

  -- プロジェクト内でスキーマを作成する権限をロールまたはユーザーに付与します。
  GRANT CreateSchema ON PROJECT <projectname> TO USER/ROLE <username>/<rolename>;
  -- プロジェクト内でスキーマを作成する権限をロールまたはユーザーから取り消します。
  REVOKE CreateSchema ON PROJECT <projectname> FROM USER/ROLE <username>/<rolename>;
  -- スキーマに対して表示、削除、その他の操作を行う権限をロールまたはユーザーに付与します。
  GRANT DESCRIBE/LIST/DROP/ALTER/ALL ON SCHEMA <schemaname> TO <username>/<rolename>;
  -- スキーマに対して表示、削除、その他の操作を行う権限をロールまたはユーザーから取り消します。
  REVOKE DESCRIBE/LIST/DROP/ALTER/ALL ON SCHEMA <schemaname> FROM <username>/<rolename>;
  -- スキーマに対して付与された権限を表示します。
  SHOW GRANTS ON SCHEMA <schemaname>;
  -- 特定のロールまたはユーザーに対して付与されたスキーマの権限を表示します。
  SHOW GRANTS ON SCHEMA <schemaname> FOR USER/ROLE <username>/<rolename>;
                      

スキーマオブジェクトに対する権限の付与および取り消し

スキーマ内の特定のオブジェクトに対して権限を付与する場合、完全な project.schema.table 形式を使用します。利用可能な権限の完全な一覧については、「MaxCompute の権限」をご参照ください。コンソールを使用して権限を管理する場合は、「コンソールによるユーザー権限の管理」をご参照ください。

-- スキーマ内のすべてのテーブルに対するロールの権限を付与します。
GRANT schemaObjectPrivileges ON TABLE <project_name>.<schema_name>.* TO role {rolename};

-- スキーマ内のすべてのテーブルに対するロールの権限を取り消します。
REVOKE schemaObjectPrivileges ON TABLE <project_name>.<schema_name>.* FROM role {rolename};

-- 特定のテーブルに対するロールまたはユーザーの権限を付与します。
GRANT schemaObjectPrivileges ON TABLE <project_name>.<schema_name>.<tablename> TO {role|user} {rolename | USER name};

-- 特定のテーブルに対するロールまたはユーザーの権限を取り消します。
REVOKE schemaObjectPrivileges ON TABLE <project_name>.<schema_name>.<tablename> FROM {role|user} {rolename | USER name};

-- テーブルに対する権限を表示します。
SHOW GRANTS ON TABLE <project_name>.<schema_name>.<tablename>;