Data Lake Formation:Acesse o DLF a partir do MaxCompute

Etapa 1: Conceder permissões

A tabela a seguir indica qual tipo de conta executa cada tarefa nesta etapa.

Etapa 2: Criar uma source de dados externa Paimon_DLF

1. Faça login no console MaxCompute e selecione sua região.

2. No painel de navegação à esquerda, escolha Manage Configurations > External Data Source.

3. Clique em Create External Data Source.

4. Configure os seguintes parâmetros:

   Parâmetro	Obrigatório	Descrição
   External Data Source Type	Obrigatório	Selecione Paimon_DLF
   External Data Source Name	Obrigatório	Deve começar com uma letra; apenas letras minúsculas, sublinhados e dígitos; máximo de 128 caracteres. Exemplo: paimon_dlf
   Description	Opcional	Descrição personalizada
   Region	Obrigatório	Padrão definido como a região atual
   Authentication And Authorization	Obrigatório	Padrão definido como Alibaba Cloud RAM role
   Service-linked Role	Obrigatório	Gerado automaticamente
   Endpoint	Obrigatório	Gerado automaticamente. Para a região China (Hangzhou): cn-hangzhou-intranet.dlf.aliyuncs.com
   Foreign Server Supplemental Properties	Opcional	Atributos adicionais para a source de dados externa

5. Clique em OK.

6. Na página External Data Source, localize a nova source de dados e clique em Details na coluna Actions para verificar a configuração.

Etapa 3: Criar um projeto externo

1. Faça login no console MaxCompute e selecione sua região.

2. No painel de navegação à esquerda, escolha Manage Configurations > Projects.

3. Na aba External Project, clique em Create Project.

4. Configure os parâmetros a seguir e clique em OK:

   Parâmetro	Obrigatório	Descrição
   Project Type	Obrigatório	Padrão definido como External Project
   Region	Obrigatório	Padrão definido como a região atual; não pode ser alterado
   Project Name (Globally Unique)	Obrigatório	Deve começar com uma letra; apenas letras, dígitos e sublinhados; 3–28 caracteres
   MaxCompute Foreign Server Type	Opcional	Padrão definido como Paimon_DLF
   MaxCompute Foreign Server	Opcional	Use Existing para selecionar uma source de dados externa criada anteriormente, ou Create Foreign Server para criar uma nova
   MaxCompute Foreign Server Name	Obrigatório	Selecione entre as sources de dados existentes ou insira o nome da nova
   Data Catalog	Obrigatório	O catálogo de dados DLF a ser anexado
   Billing Method	Obrigatório	Subscription ou Pay-as-you-go
   Default Quota	Obrigatório	Selecione uma cota existente
   Description	Opcional	Descrição personalizada

Etapa 4: Consultar e gravar dados com SQL

Select a connection tool para fazer login no projeto externo e utilize os comandos SQL a seguir.

-- 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" ao criar um projeto externo

O usuário RAM não possui as permissões necessárias. Verifique o seguinte:

O código de erro nos detalhes do erro é NoMCPermission.

1. Certifique-se de que AliyunMaxComputeFullAccess esteja anexada ao usuário RAM. Consulte Etapa 1.

2. Verifique se as permissões do DLF foram concedidas. A criação de um projeto externo Paimon_DLF requer a seleção de um catálogo DLF, o que exige acesso ao DLF. Consulte Etapa 1.

"Forbidden: User acs:ram::\<uid\>:user/\\ doesn't have privilege LIST on DATABASE default" ao executar SHOW TABLES

O usuário RAM não tem permissões do plano de dados no catálogo DLF.

1. Faça login no console DLF. No painel de navegação à esquerda, clique em System And Security. Na aba Access Control, atualize a página e verifique se o usuário RAM aparece.

2. Se o usuário existir, clique em Roles e conceda as permissões necessárias ao usuário RAM.