全部产品
Search
文档中心

AnalyticDB:BUAT DATABASE EKSTERNAL

更新时间:Feb 07, 2026

AnalyticDB for MySQL mendukung pembuatan database eksternal melalui pernyataan CREATE EXTERNAL DATABASE. Topik ini menjelaskan sintaks, catatan penggunaan, serta 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 otorisasi lintas akun.

    Penting

    Untuk operasi INSERT pada tabel eksternal OSS, berikan izin AliyunOSSFullAccess kepada RAM role tersebut.

  • Untuk membuat database eksternal Paimon, versi kluster 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 dan tabel eksternal OSS. Fitur ini tidak didukung untuk tipe lain, seperti tabel eksternal untuk RDS for MySQL atau MongoDB.

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. Tetapkan 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.

    Misalnya, jika jalur penyimpanan file Paimon adalah oss://testBucketName/OSS/Paimon/paimon.db/test, tetapkan jalur file menjadi oss://testBucketName/OSS/Paimon/paimon.db/.

  • Setelah Anda menentukan suatu jalur, AnalyticDB for MySQL hanya dapat mengakses file dalam jalur tersebut.

    Misalnya, bucket testBucketname berisi dua folder: test dan person. Jika Anda menetapkan jalur OSS ke oss://testBucketname/test/, Anda hanya dapat mengakses file dalam folder test. Anda tidak dapat mengakses 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 Lihat informasi 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/')