Data Lake Formation:Accéder à DLF depuis MaxCompute

Étape 1 : Accorder des autorisations

Le tableau suivant indique quel type de compte effectue chaque tâche de cette étape.

Étape 2 : Créer une source de données externe Paimon_DLF

1. Connectez-vous à la console MaxCompute et sélectionnez votre région.

2. Dans le volet de navigation de gauche, choisissez Manage Configurations > External Data Source.

3. Cliquez sur Create External Data Source.

4. Configurez les paramètres suivants :

   Paramètre	Obligatoire	Description
   External Data Source Type	Obligatoire	Sélectionnez Paimon_DLF
   External Data Source Name	Obligatoire	Commence par une lettre ; lettres minuscules, traits de soulignement et chiffres uniquement ; maximum 128 caractères. Exemple : paimon_dlf
   Description	Facultatif	Description personnalisée
   Region	Obligatoire	Par défaut, la région actuelle
   Authentication And Authorization	Obligatoire	Par défaut, Alibaba Cloud RAM role
   Service-linked Role	Obligatoire	Généré automatiquement
   Endpoint	Obligatoire	Généré automatiquement. Pour la région Chine (Hangzhou) : cn-hangzhou-intranet.dlf.aliyuncs.com
   Foreign Server Supplemental Properties	Facultatif	Attributs supplémentaires pour la source de données externe

5. Cliquez sur OK.

6. Sur la page External Data Source, recherchez la nouvelle source de données et cliquez sur Details dans la colonne Actions pour vérifier la configuration.

Étape 3 : Créer un projet externe

1. Connectez-vous à la console MaxCompute et sélectionnez votre région.

2. Dans le volet de navigation de gauche, choisissez Manage Configurations > Projects.

3. Sous l'onglet External Project, cliquez sur Create Project.

4. Configurez les paramètres suivants et cliquez sur OK :

   Paramètre	Obligatoire	Description
   Project Type	Obligatoire	Par défaut, External Project
   Region	Obligatoire	Par défaut, la région actuelle ; ne peut pas être modifiée
   Project Name (Globally Unique)	Obligatoire	Commence par une lettre ; lettres, chiffres et traits de soulignement uniquement ; 3 à 28 caractères
   MaxCompute Foreign Server Type	Facultatif	Par défaut, Paimon_DLF
   MaxCompute Foreign Server	Facultatif	Use Existing pour sélectionner une source de données externe précédemment créée, ou Create Foreign Server pour en créer une nouvelle
   MaxCompute Foreign Server Name	Obligatoire	Sélectionnez parmi les sources de données existantes, ou saisissez le nom de la nouvelle
   Data Catalog	Obligatoire	Le catalogue de données DLF à attacher
   Billing Method	Obligatoire	Subscription ou Pay-as-you-go
   Default Quota	Obligatoire	Sélectionnez un quota existant
   Description	Facultatif	Description personnalisée

Étape 4 : Interroger et écrire des données à l'aide de SQL

Sélectionnez un outil de connexion pour vous connecter au projet externe, puis utilisez les commandes SQL suivantes.

-- Enable schema syntax at the session level.
SET odps.namespace.schema=true;
SHOW schemas;

-- Sample output:
-- ID = 20250919****am4qb
-- default
-- system
-- OK

-- Replace <schema_name> with the schema name shown in the output above.
USE schema <schema_name>;
SHOW tables;

-- Sample output:
-- ID = 20250919****am4qb
-- acs:ram::<uid>:root  emp
-- OK

-- Replace <schema_name> with your schema name.
CREATE schema <schema_name>;

-- Create a table.
CREATE TABLE [IF NOT EXISTS] <table_name>
(
  <col_name> <data_type>,
  ...
)
[COMMENT <table_comment>]
[PARTITIONED BY (<col_name> <data_type>, ...)]
;

-- Insert data.
INSERT {INTO|OVERWRITE} TABLE <table_name> [PARTITION (<pt_spec>)] [(<col_name> [,<col_name> ...])]
<select_statement>
FROM <from_statement>

CREATE TABLE schema_table(id int, name string);

INSERT INTO schema_table VALUES (101, 'Zhang San'), (102, 'Li Si');

-- Verify the data.
SELECT * FROM schema_table;

-- Result:
-- +------------+------------+
-- | id         | name       |
-- +------------+------------+
-- | 101        | Zhang San  |
-- | 102        | Li Si      |
-- +------------+------------+

USE schema default;
SHOW tables;

-- Sample output:
-- ID = 20250919*******yg5
-- acs:ram::<uid>:root  emp
-- acs:ram::<uid>:root  emp_detail
-- acs:ram::<uid>:root  test_table
-- OK

-- Read data.
SELECT * FROM test_table;

-- Result:
-- +------------+------------+
-- | id         | name       |
-- +------------+------------+
-- | 101        | Zhang San  |
-- | 102        | Li Si      |
-- +------------+------------+

-- Write data and verify.
INSERT INTO test_table VALUES (103, 'Wang Wu');

SELECT * FROM test_table;

-- Result:
-- +------------+------------+
-- | id         | name       |
-- +------------+------------+
-- | 101        | Zhang San  |
-- | 102        | Li Si      |
-- | 103        | Wang Wu    |
-- +------------+------------+

« You are not authorized to perform this action » lors de la création d'un projet externe

L'utilisateur RAM ne dispose pas des autorisations requises. Vérifiez les points suivants :

Le code d'erreur dans les détails de l'erreur est NoMCPermission.

1. Vérifiez que AliyunMaxComputeFullAccess est attachée à l'utilisateur RAM. Consultez Étape 1.

2. Vérifiez que les autorisations DLF sont accordées. La création d'un projet externe Paimon_DLF nécessite la sélection d'un catalogue DLF, ce qui requiert un accès à DLF. Consultez Étape 1.

« Forbidden: User acs:ram::\<uid\>:user/\\ doesn't have privilege LIST on DATABASE default » lors de l'exécution de SHOW TABLES

L'utilisateur RAM ne dispose pas des autorisations du plan de données sur le catalogue DLF.

1. Connectez-vous à la console DLF. Dans le volet de navigation de gauche, cliquez sur System And Security. Sous l'onglet Access Control, actualisez la page et vérifiez si l'utilisateur RAM apparaît.

2. Si l'utilisateur existe, cliquez sur Roles et accordez les autorisations requises à l'utilisateur RAM.