All Products
Search
Document Center

DataWorks:Buat tabel eksternal Hologres

Last Updated:Jun 22, 2026

Anda dapat membuat tabel eksternal Hologres menggunakan pernyataan DDL atau alat visual di DataWorks. Topik ini menjelaskan cara menggunakan alat visual di DataWorks untuk membuat tabel eksternal Hologres.

Prasyarat

Informasi latar belakang

Hologres mendukung dua jenis tabel: tabel internal dan tabel eksternal. Keduanya berbeda dalam hal berikut:

  • Tabel internal menyimpan data secara langsung dari MaxCompute. Anda dapat menyinkronkan data dari tabel sumber MaxCompute ke tabel internal Hologres untuk kueri dan analisis yang cepat. Metode ini menawarkan performa kueri lebih baik dibandingkan menggunakan tabel eksternal.

  • Tabel eksternal tidak menyimpan data secara langsung. Sebaliknya, tabel tersebut memetakan ke tabel sumber MaxCompute untuk mempercepat kueri dan analisis data. Metode ini menghindari redundansi data serta menghilangkan kebutuhan impor dan ekspor data, sehingga Anda dapat memperoleh hasil kueri dengan cepat.

DataWorks, sebagai platform pengembangan data, menyediakan metode visual yang praktis untuk membuat tabel. Untuk membuat beberapa tabel eksternal Hologres sekaligus, Anda dapat menggunakan fitur Sinkronisasi skema dari MaxCompute. Anda juga dapat membuat tabel secara langsung di Hologres menggunakan pernyataan DDL. Untuk informasi selengkapnya, lihat CREATE FOREIGN TABLE.

Batasan

  • Anda hanya dapat membuat tabel eksternal Hologres yang dipetakan ke tabel MaxCompute.

  • Fitur ini hanya tersedia di wilayah China (Shanghai) dan China (Beijing).

Prosedur

  1. Buka halaman Data Studio.

    Masuk ke Konsol DataWorks. Di wilayah target, klik Data Integration > Data Integration di panel navigasi kiri. Pilih ruang kerja dari daftar drop-down dan klik Go to Data Integration.

  2. Buat Workflow.

    Jika Anda sudah memiliki Workflow, lewati langkah ini.

    1. Arahkan kursor ke ikon 新建 dan pilih Create Workflow.

    2. Di kotak dialog Create Workflow, masukkan Workflow Name.

    3. Klik Create.

  3. Buat tabel eksternal Hologres.

    1. Arahkan kursor ke ikon 新建 dan pilih Create Table > Hologres > Table.

    2. Di kotak dialog Create Table, pilih External Table untuk Table Type, lalu konfigurasikan engine, path, dan nama tabel.

      Setelah konfigurasi selesai, klik Create.

  4. Konfigurasikan tabel eksternal Hologres.

    Di halaman konfigurasi tabel eksternal Hologres, atur properti tabel tersebut.

    1. Konfigurasikan properti dasar.

      Tabel berikut menjelaskan properti dasar utama.

      Parameter

      Deskripsi

      Type

      Jenis tabel eksternal Hologres yang akan dibuat.

      Catatan

      Anda hanya dapat membuat tabel eksternal Hologres yang dipetakan ke tabel MaxCompute.

      Servers

      Server yang digunakan oleh tabel eksternal untuk terhubung ke sumber data MaxCompute.

      Catatan

      Untuk membuat tabel eksternal untuk MaxCompute, Anda harus memanggil server tabel eksternal odps_server yang telah dibuat di lapisan bawah Hologres. Untuk informasi selengkapnya tentang prinsipnya, lihat postgres_fdw.

      Table

      Tabel sumber MaxCompute yang dikueri oleh tabel eksternal Hologres.

      Anda harus mengonfigurasi parameter berikut berdasarkan tipe model proyek MaxCompute:

      • two-layer model:

        • project_name: nama proyek MaxCompute.

        • table_name: nama tabel sumber MaxCompute yang akan dikueri.

      • three-layer model:

        • project_name: nama proyek dan skema MaxCompute, dalam format odps_project_name#odps_schema_name.

        • table_name: nama tabel sumber MaxCompute yang akan dikueri.

      Catatan

      Jika parameter yang dikonfigurasi tidak sesuai dengan persyaratan tipe model, akan muncul error. Contoh: failed to import foreign schema:Table not found - table_xxx.

    2. Konfigurasikan informasi bisnis.

      Catatan

      Informasi bisnis tabel hanya digunakan untuk keperluan manajemen berdasarkan kebutuhan bisnis dan tidak melibatkan implementasi logika tingkat bawah.

      Parameter

      Deskripsi

      Theme

      Folder level-1 dan level-2 tempat tabel tersebut berada. Anda dapat mengklasifikasikan tabel berdasarkan tujuan bisnis dan menempatkan tabel dengan tipe yang sama dalam folder yang sama.

      Catatan

      Theme level-1 dan level-2 hanyalah struktur folder yang ditampilkan di DataWorks dan bertujuan membantu Anda mengelola tabel.

      Layer

      Lapisan gudang data fisik tempat tabel tersebut berada. Layer digunakan untuk mendefinisikan dan mengelola hierarki gudang data. Layer umum meliputi staging layer, shared layer, dan analytics layer. Anda dapat menetapkan tabel ke layer yang sesuai berdasarkan tujuan bisnisnya.

      Catatan

      Klik ikon Create icon untuk menyesuaikan layer. Untuk informasi selengkapnya, lihat Manajemen tabel.

      Physical Category

      Kategori fisik tabel. Ini memberikan klasifikasi lebih rinci terhadap tabel dari perspektif bisnis. Kategori umum meliputi basic business layer, advanced business layer, dan lainnya.

      Catatan

      Klik ikon Create icon untuk menyesuaikan kategori fisik. Untuk informasi selengkapnya, lihat Manajemen kategori.

    3. Konfigurasikan skema tabel.

      Di halaman Table Structure Design, buka tab Field Design dan pilih field yang akan dipetakan ke tabel eksternal Hologres. Dalam contoh ini, dua field bertipe teks smischema dan smitable dipilih. Setelah Anda mengonfigurasi parameter Table di bagian Konfigurasikan properti dasar pada Langkah 4, skema dari tabel sumber MaxCompute akan ditampilkan secara otomatis. Skema ini digunakan untuk membuat tabel eksternal Hologres akhir dan tidak dapat diedit.

      Catatan

      Saat membuat tabel eksternal Hologres berdasarkan tabel MaxCompute, tipe data antara keduanya dipetakan. Tipe field di tabel eksternal harus berkorespondensi satu-satu dengan tipe field di tabel sumber MaxCompute. Untuk informasi tentang pemetaan tipe data antara MaxCompute dan Hologres, lihat Pemetaan tipe data antara MaxCompute dan Hologres.

  5. Commit dan deploy tabel eksternal Hologres.

    Setelah Anda menentukan struktur tabel, Anda harus menyerahkannya ke lingkungan pengembangan dan lingkungan produksi. Tabel tersebut hanya akan terlihat di proyek engine yang sesuai setelah berhasil diserahkan.

    Catatan

    Jika ruang kerja Anda berada dalam mode dasar, Anda hanya perlu menyerahkan tabel ke lingkungan produksi. Untuk informasi selengkapnya tentang ruang kerja mode dasar dan mode standar, lihat Perbedaan mode ruang kerja.

    Operasi

    Deskripsi

    Load from Development Environment

    Memuat informasi tabel pengembangan dari lingkungan pengembangan dan menampilkannya di halaman saat ini.

    Catatan

    Operasi ini hanya tersedia setelah tabel diserahkan ke lingkungan pengembangan. Setelah operasi ini dilakukan, informasi tabel dari lingkungan pengembangan akan menimpa informasi tabel di halaman saat ini.

    Commit to Development Environment

    Menyerahkan tabel ke lingkungan pengembangan DataWorks, yang membuat tabel tersebut di database Hologres yang sesuai dengan lingkungan pengembangan.

    Setelah menyerahkan tabel, Anda dapat melihat struktur tabel di direktori Hologres dari workflow yang sesuai (path yang Anda pilih saat membuat tabel) di Data Studio.

    Load from Production Environment

    Memuat informasi tabel produksi dari lingkungan produksi dan menampilkannya di halaman saat ini.

    Catatan

    Operasi ini hanya tersedia setelah tabel diserahkan ke lingkungan produksi. Setelah operasi ini dilakukan, informasi tabel dari lingkungan produksi akan menimpa informasi tabel di halaman saat ini.

    Commit to Production Environment

    Menyerahkan tabel ke lingkungan produksi DataWorks, yang membuat tabel tersebut di database Hologres yang sesuai dengan lingkungan produksi.

Langkah selanjutnya

Setelah tabel eksternal Hologres dibuat, Anda dapat menggunakannya untuk mengimpor data dari MaxCompute ke tabel internal Hologres secara berkala. Anda dapat menggunakan salah satu metode berikut untuk mengimpor data: