Hologres：IMPORT FOREIGN SCHEMA

Detail fitur

IMPORT FOREIGN SCHEMA adalah fitur Hologres yang membuat tabel eksternal secara batch. Fitur ini secara otomatis memetakan skema tabel dari sumber data remote ke tabel eksternal Hologres, sehingga menghilangkan kebutuhan untuk membuat setiap tabel secara manual. Saat ini, fitur ini mendukung dua jenis sumber data berikut:

• Tabel MaxCompute: Impor batch tabel eksternal dari model dua lapis atau tiga lapis MaxCompute.

• Tabel Paimon di DLF: Buat batch tabel eksternal Hologres dari tabel Paimon di Data Lake Formation (DLF).

Batasan

• Saat menggunakan pernyataan IMPORT FOREIGN SCHEMA, tambahkan klausa LIMIT TO untuk menentukan tabel yang akan diimpor, dengan nama tabel tersebut dituliskan dalam tanda kurung. Jika klausa ini dihilangkan, sistem akan membuat tabel eksternal di Hologres untuk semua tabel dalam proyek MaxCompute target.

• Hanya Hologres V1.1.26 dan versi yang lebih baru yang mendukung penambahan awalan dan akhiran pada nama tabel eksternal yang dibuat menggunakan IMPORT FOREIGN SCHEMA. Jika instans Anda menggunakan versi sebelum V1.1.26, lihat Kesalahan umum saat mempersiapkan upgrade atau bergabunglah dengan grup DingTalk Hologres untuk memberikan masukan. Untuk informasi selengkapnya, lihat Bagaimana cara mendapatkan dukungan online lebih lanjut?.

• Versi Hologres V1.3 dan yang lebih baru mendukung model tiga lapis MaxCompute, yang menambahkan lapisan Schema antara Project dan Table. Untuk informasi selengkapnya, lihat Operasi Schema. Untuk membuat tabel eksternal di Hologres dari proyek MaxCompute yang menggunakan model tiga lapis, Anda harus menggunakan Hologres V1.3 atau versi yang lebih baru. Jika Anda menggunakan versi Hologres yang lebih lama, lihat Kesalahan umum saat mempersiapkan upgrade atau bergabunglah dengan grup DingTalk Hologres untuk memberikan masukan. Untuk informasi selengkapnya, lihat Bagaimana cara mendapatkan dukungan online lebih lanjut?.

Format perintah

IMPORT FOREIGN SCHEMA remote_schema
    [ { LIMIT TO | EXCEPT } ( table_name [, ...] ) ]
    FROM SERVER odps_server
    INTO local_schema 
    [ OPTIONS ( option 'value' [, ... ] ) ]

Deskripsi parameter

Contoh penggunaan

• Model dua lapis MaxCompute

  Contoh berikut menunjukkan cara membuat tabel eksternal secara batch di Hologres dari tabel dalam dataset publik MaxCompute public_data.

  • Contoh 1: Buat tabel eksternal baru untuk schema public. Jika tabel sudah ada, perbarui.

    IMPORT FOREIGN SCHEMA public_data LIMIT TO
    (customer) 
      FROM server odps_server INTO PUBLIC options(if_table_exist 'update');

  • Contoh 2: Buat tabel eksternal secara batch untuk schema public.

     IMPORT FOREIGN SCHEMA public_data LIMIT TO(
      customer,
      customer_address,
      customer_demographics,
      inventory,item,
      date_dim,
      warehouse) 
      FROM server odps_server INTO PUBLIC options(if_table_exist 'update');

  • Contoh 3: Buat schema testdemo dan buat tabel eksternal secara batch.

    CREATE schema testdemo;
    
    IMPORT FOREIGN SCHEMA public_data LIMIT TO(
      customer,
      customer_address,
      customer_demographics,
      inventory,item,
      date_dim,
      warehouse) 
      FROM server odps_server INTO testdemo options(if_table_exist 'update');
      
    SET search_path TO testdemo;

  • Contoh 4: Buat tabel eksternal secara batch di schema public. Jika tabel eksternal sudah ada, laporkan error.

    IMPORT FOREIGN SCHEMA public_data LIMIT to
    (customer,
      customer_address) 
      FROM server odps_server INTO PUBLIC options(if_table_exist 'error');

  • Contoh 5: Buat tabel eksternal secara batch di schema public. Jika tabel eksternal sudah ada, lewati.

    IMPORT FOREIGN SCHEMA public_data LIMIT to
    (customer,
      customer_address) 
      FROM server odps_server INTO PUBLIC options(if_table_exist 'ignore');

• Model tiga lapis MaxCompute

  Anda dapat membuat tabel eksternal di Hologres yang dipetakan ke tabel odps_region_10g dalam skema tpch_10g dari proyek MaxCompute odps_hologres.

  IMPORT FOREIGN SCHEMA "odps_hologres#tpch_10g" LIMIT to
  (
      odps_region_10g
  )
  FROM SERVER odps_server INTO public OPTIONS(if_table_exist 'error',if_unsupported_type 'error');

• Sumber data DLF

  Untuk sumber data DLF, buat langsung tabel eksternal Hologres dengan menentukan nama sumber data, seperti github_events.

  • Contoh: Buat tabel eksternal baru untuk schema public. Jika tabel sudah ada, perbarui. Untuk informasi selengkapnya, lihat Akses katalog Paimon berdasarkan DLF.

    IMPORT FOREIGN SCHEMA github_events
    limit to (customer) 
    FROM SERVER paimon_server into public
    options (if_table_exist 'update');