CREATE EXTERNAL DATABASE - AnalyticDB - Centre de documentation Alibaba Cloud

AnalyticDB for MySQL permet de créer des bases de données externes à l'aide de l'instruction CREATE EXTERNAL DATABASE. Cette rubrique décrit la syntaxe, les remarques d'utilisation et des exemples relatifs à cette instruction.

Prérequis

Vous avez créé un cluster AnalyticDB for MySQL Enterprise Edition, Basic Edition ou Data Lakehouse Edition.
Pour créer une base de données externe OSS entre différents comptes, créez un rôle RAM, modifiez sa stratégie d'approbation et accordez-lui l'autorisation AliyunOSSReadOnlyAccess. Pour plus d'informations, consultez la section Autorisation entre comptes.

Important
Pour les opérations INSERT sur une table externe OSS, accordez l'autorisation AliyunOSSFullAccess au rôle RAM.
Pour créer une base de données externe Paimon, votre cluster doit être en version 3.2.6.1 ou ultérieure.

Remarque
Pour afficher et mettre à jour la version mineure, accédez à la section Configuration Information de la page Cluster Information dans la console AnalyticDB for MySQL.

Remarques d'utilisation

Le moteur Spark ne prend pas en charge l'instruction CREATE EXTERNAL DATABASE. Utilisez le moteur XIHE.
Dans une base de données externe créée avec cette commande, créez des tables externes uniquement via la syntaxe CREATE EXTERNAL TABLE. Pour plus d'informations, consultez la section CREATE EXTERNAL TABLE.
La création entre comptes n'est disponible que pour les bases de données et les tables externes OSS.

Syntaxe

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

Paramètres

Paramètre	Obligatoire	Description
db_name	Oui	Nom de la base de données.
catalog	Non Remarque Ce paramètre est obligatoire uniquement lors de la création d'une base de données externe OSS entre différents comptes.	Moteur de base de données. Définissez ce paramètre sur oss lors de la création d'une base de données externe OSS entre différents comptes.
location	Non	Chemin du fichier ou du dossier OSS. Pour un fichier au format Paimon, spécifiez le chemin du dossier contenant le fichier `*.db`. Par exemple, si le chemin de stockage du fichier Paimon est `oss://testBucketName/OSS/Paimon/paimon.db/test`, définissez le chemin du fichier sur `oss://testBucketName/OSS/Paimon/paimon.db/`. Une fois le chemin spécifié, AnalyticDB for MySQL n'accède qu'aux fichiers situés dans ce chemin. Par exemple, le bucket `testBucketname` contient deux dossiers : `test` et `person`. Si vous définissez le chemin OSS sur `oss://testBucketname/test/`, vous n'accédez qu'aux fichiers du dossier `test`. Vous ne pouvez pas accéder aux fichiers du dossier `person`.
cross_account_accessing_arn	Non Remarque Ce paramètre est obligatoire uniquement lors de la création d'une base de données externe OSS entre différents comptes.	Alibaba Cloud Resource Name (ARN) du rôle RAM. Pour savoir comment consulter l'ARN, consultez la section Afficher les informations d'un rôle RAM.

Exemples

Créez une base de données externe au sein du même compte.

CREATE EXTERNAL DATABASE IF NOT EXISTS adb_demo;

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

Créez une base de données externe entre différents comptes.

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');

Créez une base de données externe Paimon.

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