CREATE EXTERNAL DATABASE - AnalyticDB - Alibaba Cloud Documentation Center

AnalyticDB for MySQL mendukung pembuatan database eksternal melalui pernyataan CREATE EXTERNAL DATABASE. Topik ini menjelaskan sintaksis, catatan penggunaan, dan contoh penggunaan pernyataan CREATE EXTERNAL DATABASE.

Prasyarat

Kluster AnalyticDB for MySQL Edisi Perusahaan, Edisi Dasar, atau Edisi Data Lakehouse telah dibuat.
Untuk membuat database eksternal OSS lintas akun, Anda harus terlebih dahulu membuat RAM role, mengubah kebijakan kepercayaannya, dan memberikan izin AliyunOSSReadOnlyAccess kepada role tersebut. Untuk informasi selengkapnya, lihat Cross-account authorization.
Penting
Untuk operasi INSERT pada tabel eksternal OSS, berikan izin AliyunOSSFullAccess kepada RAM role.
Untuk membuat database eksternal Paimon, versi kluster Anda harus 3.2.6.1 atau lebih baru.
Catatan
Untuk melihat dan memperbarui versi minor, buka bagian Configuration Information pada halaman Cluster Information di Konsol AnalyticDB for MySQL.

Catatan penggunaan

Engine Spark tidak mendukung pernyataan CREATE EXTERNAL DATABASE. Anda harus menggunakan engine XIHE.
Pada database eksternal yang dibuat menggunakan perintah ini, Anda hanya dapat membuat tabel eksternal dengan sintaks CREATE EXTERNAL TABLE. Untuk informasi selengkapnya, lihat CREATE EXTERNAL TABLE.
Pembuatan lintas akun hanya didukung untuk database eksternal dan tabel eksternal OSS.

Sintaks

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

Parameter

Parameter	Wajib	Deskripsi
db_name	Ya	Nama database.
catalog	Tidak Catatan Parameter ini wajib hanya saat Anda membuat database eksternal OSS lintas akun.	Engine database. Atur parameter ini ke oss saat membuat database eksternal OSS lintas akun.
location	Tidak	Jalur file atau folder OSS. Untuk file berformat Paimon, tentukan jalur folder yang berisi file `*.db`. Contohnya, jika jalur penyimpanan file Paimon adalah `oss://testBucketName/OSS/Paimon/paimon.db/test`, atur jalur filenya menjadi `oss://testBucketName/OSS/Paimon/paimon.db/`. Setelah Anda menentukan jalur, AnalyticDB for MySQL hanya dapat mengakses file-file dalam jalur tersebut. Sebagai contoh, bucket `testBucketname` berisi dua folder: `test` dan `person`. Jika Anda mengatur jalur OSS ke `oss://testBucketname/test/`, Anda hanya dapat mengakses file-file dalam folder `test`. Anda tidak dapat mengakses file-file dalam folder `person`.
cross_account_accessing_arn	Tidak Catatan Parameter ini wajib hanya saat Anda membuat database eksternal OSS lintas akun.	Nama Sumber Daya Alibaba Cloud (ARN) dari RAM role. Untuk informasi selengkapnya tentang cara melihat ARN, lihat View the information of a RAM role.

Contoh

Buat database eksternal dalam akun yang sama.

CREATE EXTERNAL DATABASE IF NOT EXISTS adb_demo;

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

Buat database eksternal lintas akun.

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

Buat database eksternal Paimon.

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