MaxCompute:FileSystem Catalog 外部プロジェクト

ステップ 1：RAM ユーザーに権限を付与

Resource Access Management (RAM) ユーザーとして操作する場合は、以下のアクセスポリシーをアタッチしてください。権限の追加方法については、「RAM ユーザーの権限管理」をご参照ください。

• AliyunMaxComputeFullAccess：外部データソースおよび外部プロジェクトの作成権限を付与します。

ステップ 2：Filesystem Catalog 外部データソースの作成

1. OSS を有効化し、Paimon データを格納するバケットを作成します。詳細については、「クイックスタート」をご参照ください。

2. MaxCompute コンソールにログインし、左上隅からリージョンを選択します。

3. 左側のナビゲーションウィンドウで、構成の管理 > 外部データソース を選択します。

4. 外部データソース ページで、外部データソースの作成 をクリックします。

5. 外部データソースの追加 ダイアログボックスで、パラメーターを設定します。以下の表にパラメーターの説明を示します。

   パラメーター	必須	説明
   外部データソースタイプ	必須	Filesystem Catalog を選択します。
   外部データソース名	必須	任意の名前を指定します。命名規則は以下のとおりです： 英字で始まり、小文字、アンダースコア (_ )、数字のみ使用可能。 最大 128 文字まで。 例：external_fs。
   外部データソースの説明	任意	必要に応じて情報を入力します。
   地理	必須	現在のリージョンがデフォルトで使用されます。
   認証および権限付与	必須	Alibaba Cloud RAM ロールがデフォルトで使用されます。
   RoleARN	必須	RAM ロールの Alibaba Cloud Resource Name (ARN)。このロールには OSS サービスへのアクセス権限が含まれている必要があります。 Resource Access Management (RAM) コンソール にログインします。 左側のナビゲーションウィンドウで、ID > ロール を選択します。 基本情報 セクションで、ARN を確認できます。 例：acs:ram::124****:role/aliyunodpsdefaultrole。
   Storage Type	必須	OSS OSS-HDFS
   エンドポイント	必須	自動生成されます。中国 (杭州) リージョンの場合、エンドポイントは oss-cn-hangzhou-internal.aliyuncs.com です。
   外部データソースの追加プロパティ	任意	外部データソース向けの追加属性を指定します。これらの属性を設定すると、当該データソースを使用するタスクは、定義された動作に基づいてソースシステムにアクセスできるようになります。 説明 サポートされるパラメーターについては、公式ドキュメントをご参照ください。具体的なパラメーターは、製品の進化に伴い段階的に追加されます。

6. 確認 をクリックして外部データソースを作成します。

7. 外部データソース ページで、対象のデータソースを見つけ、詳細 をクリックします（操作 列内）。

ステップ 3：外部プロジェクトの作成

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

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

3. External Project タブで、新しいプロジェクト をクリックします。

4. 新しいアイテム ダイアログボックスで、画面の指示に従ってプロジェクト情報を設定し、OK をクリックします。

   パラメーター	必須	説明
   プロジェクトタイプ	必須	外部プロジェクトがデフォルトで選択されます。
   地理	必須	現在のリージョンがデフォルトで使用され、変更できません。
   プロジェクト名 (ネットワーク全体で一意)	必須	英字で始まり、英字、数字、アンダースコア (_) のみ使用可能。長さは 3～28 文字です。
   MaxCompute外部データソース型	任意	Filesystem Catalog を選択します。
   MaxCompute外部データソース	任意	既存の選択：作成済みの外部データソースの一覧を表示します。 新しい外部データソース：新しい外部データソースを作成して使用します。
   MaxCompute外部データソース名	必須	既存のものを使用：ドロップダウンリストから作成済みの外部データソースを選択します。 外部データソースの作成：新しく作成する外部データソースの名前が使用されます。
   Bucket Catalog	必須	OSS バケットからカタログレベルのファイルシステムディレクトリまでの完全パスを指定します。本例では、パスは oss://paimon-fs/paimon-test/ です。
   テーブル形式	（必須）	Paimon がデフォルトで使用されます。
   コンピューティングリソース支払いタイプ	必須	年と月 または ボリュームで支払う。
   デフォルトクォータ	必須	既存のクォータを選択します。
   説明	任意	プロジェクトのカスタム説明。

ステップ 4：SQL を使用したデータソースシステムへのアクセス

1. 接続ツールの選択 を行って、外部プロジェクトにログインします。

2. 外部プロジェクト内のスキーマを一覧表示します。デフォルトでは、Paimon テーブルを格納する DB パスのみが表示されます。

   -- セッションレベルでスキーマ構文を有効化します。
   SET odps.namespace.schema=true;
   SHOW schemas;
   
   -- 以下のような結果が返されます。
   ID = 20250922********wbh2u7
   default
   
   
   OK

3. 外部プロジェクト内のスキーマに含まれるテーブルを一覧表示します。

   -- <schema_name> は、外部プロジェクトに表示されるスキーマ名です。
   USE SCHEMA <schema_name>; 
   SHOW tables;

4. 外部プロジェクト内にスキーマを作成します。

   CREATE schema <schema_name>;
   
   -- 例：
   CREATE schema schema_test;

5. 新しく作成したスキーマを使用します。

   use schema <schema_name>;
   
   -- 例：
   use schema schema_test;

6. スキーマ内にテーブルを作成し、データを挿入します。

   • 構文：

     -- テーブルの作成。
     CREATE TABLE [IF NOT EXISTS] <table_name> 
     (
       <col_name> <data_type>,
       ...
     )
     [COMMENT <table_comment>]
     [PARTITIONED BY (<col_name> <data_type>, ...)] 
     ;
     
     -- データの挿入。
     INSERT {INTO|OVERWRITE} TABLE <table_name> [PARTITION (<pt_spec>)] [(<col_name> [,<col_name> ...)]]
     <select_statement>
     FROM <from_statement>

   • 例：

     CREATE TABLE new_table(id INT,name STRING);
     
     INSERT INTO new_table VALUES (101,'田中一郎'),(102,'山田太郎');
     
     -- new_table テーブルをクエリします。
     SELECT * FROM new_table;
     
     -- 以下のような結果が返されます。
     +------------+------------+
     | id         | name       | 
     +------------+------------+
     | 101        | 田中一郎   | 
     | 102        | 山田太郎   | 
     +------------+------------+