CREATE EXTERNAL DATABASE - AnalyticDB: Central de Documentação do Alibaba Cloud

AnalyticDB for MySQL permite criar bancos de dados externos com a instrução CREATE EXTERNAL DATABASE. Este tópico descreve a sintaxe, as observações de uso e os exemplos dessa instrução.

Pré-requisitos

Você já criou um cluster do AnalyticDB for MySQL Enterprise Edition, Basic Edition ou Data Lakehouse Edition.
Para criar um banco de dados externo do OSS entre contas, crie primeiro uma função do RAM, modifique sua política de confiança e conceda a permissão AliyunOSSReadOnlyAccess à função. Para mais informações, consulte Autorização entre contas.

Importante
Para executar operações INSERT em uma tabela externa do OSS, conceda a permissão AliyunOSSFullAccess à função do RAM.
Para criar um banco de dados externo Paimon, a versão do cluster deve ser 3.2.6.1 ou posterior.

Nota
Para visualizar e atualizar a versão secundária, acesse a seção Configuration Information na página Cluster Information no console do AnalyticDB for MySQL.

Observações de uso

O mecanismo Spark não oferece suporte à instrução CREATE EXTERNAL DATABASE. Use o mecanismo XIHE.
Em bancos de dados externos criados com este comando, é possível criar tabelas externas apenas com a sintaxe CREATE EXTERNAL TABLE. Para mais informações, consulte CREATE EXTERNAL TABLE.
A criação entre contas tem suporte apenas para bancos de dados e tabelas externas do OSS.

Sintaxe

CREATE EXTERNAL DATABASE [IF NOT EXISTS] <db_name> 
[WITH DBPROPERTIES(
catalog='oss',
location = '<oss_location>',
cross_account_accessing_arn= '<ARN>')]

Parâmetros

Parâmetro	Obrigatório	Descrição
db_name	Sim	Nome do banco de dados.
catalog	Não Nota Este parâmetro é obrigatório apenas ao criar um banco de dados externo do OSS entre contas.	Mecanismo do banco de dados. Defina este parâmetro como oss ao criar um banco de dados externo do OSS entre contas.
location	Não	Caminho do arquivo ou da pasta no OSS. Para arquivos no formato Paimon, especifique o caminho da pasta que contém o arquivo `*.db`. Por exemplo, se o caminho de armazenamento do arquivo Paimon for `oss://testBucketName/OSS/Paimon/paimon.db/test`, defina o caminho do arquivo como `oss://testBucketName/OSS/Paimon/paimon.db/`. Após especificar um caminho, o AnalyticDB for MySQL acessará apenas os arquivos nesse local. Por exemplo, o bucket `testBucketname` contém duas pastas: `test` e `person`. Se você definir o caminho do OSS como `oss://testBucketname/test/`, será possível acessar apenas os arquivos da pasta `test`. Os arquivos da pasta `person` não estarão acessíveis.
cross_account_accessing_arn	Não Nota Este parâmetro é obrigatório apenas ao criar um banco de dados externo do OSS entre contas.	ARN (Alibaba Cloud Resource Name) da função do RAM. Para mais informações sobre como visualizar o ARN, consulte Visualizar as informações de uma função do RAM.

Exemplos

Crie um banco de dados externo na mesma conta.

CREATE EXTERNAL DATABASE IF NOT EXISTS adb_demo;

CREATE EXTERNAL DATABASE IF NOT EXISTS db_external_test
WITH DBPROPERTIES(
location = 'oss://testBucketname/person');

Crie um banco de dados externo entre contas.

CREATE EXTERNAL DATABASE IF NOT EXISTS adb_demo1 
WITH DBPROPERTIES(
catalog='oss',
location = 'oss://testBucketname/test/',
cross_account_accessing_arn= 'acs:ram::16274839*****:role/username');

Crie um banco de dados externo Paimon.

CREATE EXTERNAL DATABASE IF NOT EXISTS paimon_complex
WITH DBPROPERTIES(location = 'oss://testBucketName/paimon/paimon_complex.db/')