Buat server eksternal, buat tabel eksternal - Hologres - Alibaba Cloud Documentation Center

Di Hologres, Anda dapat mengonfigurasi server eksternal untuk menentukan informasi koneksi ke sumber data eksternal, seperti bucket Object Storage Service (OSS). Setelah itu, Anda dapat membuat tabel eksternal untuk mengakses dan melakukan kueri terhadap data lintas sistem. Topik ini menjelaskan cara menggunakan alat visualisasi HoloWeb untuk membuat server eksternal, mengelola tabel eksternal, dan melihat pratinjau data.

Prasyarat

Bucket OSS telah dibuat dan data telah diimpor ke bucket tersebut. Untuk informasi selengkapnya, lihat Memulai OSS.
Katalog Data Lake Formation (DLF) telah dibuat. Untuk informasi selengkapnya, lihat Katalog data.
Akun Anda telah diberikan izin USAGE pada pembungkus data asing (FDW) yang digunakan. Untuk informasi selengkapnya, lihat Otorisasi izin.
Database dan tabel sudah ada di katalog DLF dari server eksternal. Untuk informasi tentang cara membuat database dan tabel, lihat Tabel dan fungsi database.

Batasan

Sumber data eksternal dan tabel eksternal Hologres yang dipetakan harus berada di wilayah yang sama.

Buat server eksternal

Di Hologres, server eksternal digunakan untuk mendefinisikan informasi koneksi yang digunakan FDW untuk mengakses sumber data eksternal, seperti bucket OSS, demi akses dan kueri data lintas sistem. Anda juga dapat membuat pemetaan pengguna guna menentukan informasi koneksi spesifik pengguna. Untuk informasi selengkapnya, lihat Buat server eksternal.

Masuk ke konsol Hologres.
Di bilah navigasi atas, pilih wilayah dari daftar drop-down.
Di panel navigasi kiri, klik Instances. Di kolom Actions instans target Anda, klik Lake Acceleration untuk mengaktifkan fitur ini.
Klik Go to HoloWeb untuk membuka halaman pengembangan HoloWeb.
Setelah masuk ke database target, klik Metadata Management di bilah navigasi atas.

Di halaman Metadata Management, pilih OSS Data Lake Acceleration > Create Foreign Server.

Server Name harus dimulai dengan huruf atau garis bawah (_), hanya boleh berisi huruf, angka, dan garis bawah, serta panjangnya antara 1 hingga 63 karakter.

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi
Server Name	Nama server eksternal yang ingin Anda buat. Penting Nama server eksternal harus unik dalam database.
DLF EndPoint	Titik akhir DLF. Secara default, titik akhir DLF di wilayah saat ini digunakan. Untuk informasi selengkapnya tentang wilayah dan titik akhir DLF yang didukung, lihat Wilayah dan titik akhir yang didukung.
DLF Catalog	Pilih katalog DLF yang sudah ada dari daftar drop-down. Jika daftarnya kosong, klik Create in DLF Console untuk membuatnya.
OSS EndPoint	Secara default, Endpoint OSS native di wilayah saat ini digunakan. Anda dapat memilih Endpoint OSS-HDFS dari daftar drop-down. Jika Anda belum memiliki bucket OSS, klik Create in OSS Console. Catatan Anda dapat memperoleh endpoint OSS dari Wilayah dan titik akhir. Anda dapat menemukan Endpoint OSS-HDFS di halaman Overview bucket yang telah diaktifkan OSS-HDFS di konsol OSS.

Klik Submit untuk membuat server eksternal.

Buat tabel eksternal

Masuk ke konsol Hologres.
Di bilah navigasi atas, pilih wilayah dari daftar drop-down.
Klik Go to HoloWeb untuk membuka halaman pengembangan HoloWeb.
Di bilah navigasi atas HoloWeb, klik Metadata Management.

Di halaman Metadata Management, pilih OSS Data Lake Acceleration > Create Foreign Table.

Anda dapat memilih Entire Project, Selected Tables, atau Single Table sebagai metode akselerasi. Tabel-tabel berikut menjelaskan parameter yang terkait dengan masing-masing metode akselerasi.

Entire Project

Kategori	Parameter	Deskripsi
Metode Akselerasi	Entire Project	Metode yang membuat tabel eksternal Hologres untuk semua tabel sumber di database tertentu dalam DLF.
Sumber Data DLF	Server Name	Nama server eksternal yang telah Anda buat. Parameter ini digunakan untuk menentukan informasi koneksi sumber data eksternal.
Sumber Data DLF	DB Name	Nama database di katalog DLF yang ditentukan dalam server eksternal.
Lokasi Tujuan	Holo Schema	Nilai default-nya adalah public. Anda dapat memilih skema lain yang memiliki izin dari daftar drop-down.
Pengaturan Lanjutan	Aturan Penanganan Konflik Nama Tabel	Aturan penanganan jika tabel eksternal yang ingin Anda buat memiliki nama yang sama dengan tabel eksternal yang sudah ada di database. Nilai yang valid: Ignore Conflicts and Continue Creating Tables: Sistem melewati pembuatan tabel ini dan melanjutkan pembuatan tabel lainnya. Change Table Names: Sistem memperbarui data di tabel eksternal yang sudah ada. Report Error and Create No Table: Sistem menampilkan pesan error dan menghentikan pembuatan tabel.
Pengaturan Lanjutan	Aturan Penanganan Tipe Data yang Tidak Didukung	Aturan penanganan jika tipe data tertentu di tabel sumber tidak didukung oleh Hologres. Nilai yang valid: Report Error and Stop Import: Sistem menampilkan pesan error, dan impor data gagal. Ignore and Skip Table of Unsupported Fields: Melewatkan tabel yang memiliki bidang tidak didukung dan melanjutkan impor.

Selected Tables

Kategori	Parameter	Deskripsi
Metode Akselerasi	Selected Tables	Metode yang membuat tabel eksternal Hologres untuk tabel sumber tertentu. Anda dapat mencari tabel dengan memasukkan nama tabel di kotak pencarian untuk pencocokan kabur.
Sumber Data DLF	Server Name	Nama server eksternal yang telah Anda buat. Parameter ini digunakan untuk menentukan informasi koneksi sumber data eksternal.
Sumber Data DLF	DB Name	Nama database di katalog DLF yang ditentukan dalam server eksternal.
Lokasi Tujuan	Holo Schema	Nilai default-nya adalah public. Anda dapat memilih skema lain yang memiliki izin dari daftar drop-down.
Pengaturan Lanjutan	Aturan Penanganan Konflik Nama Tabel	Aturan penanganan jika tabel eksternal yang ingin Anda buat memiliki nama yang sama dengan tabel eksternal yang sudah ada di database. Nilai yang valid: Ignore Conflicts and Continue Creating Tables: Sistem melewati pembuatan tabel ini dan melanjutkan pembuatan tabel lainnya. Change Table Names: Sistem memperbarui data di tabel eksternal yang sudah ada. Report Error and Create No Table: Sistem menampilkan pesan error dan menghentikan pembuatan tabel.
	Aturan Penanganan Tipe Data yang Tidak Didukung	Aturan penanganan jika tipe data tertentu di tabel sumber tidak didukung oleh Hologres. Nilai yang valid: Report Error and Stop Import: Sistem menampilkan pesan error, dan impor data gagal. Ignore and Skip Table of Unsupported Fields: Melewatkan tabel yang memiliki bidang tidak didukung dan melanjutkan impor.
	Search	Menjalankan pencocokan kabur untuk mencari tabel berdasarkan nama tabel lalu memilih tabel.

Single Table

Kategori	Parameter	Deskripsi
Metode Akselerasi	Single Table	Metode yang membuat satu tabel eksternal Hologres untuk tabel sumber tertentu.
Sumber Data DLF	Server Name	Nama server eksternal yang telah Anda buat. Parameter ini digunakan untuk menentukan informasi koneksi sumber data eksternal.
	DB Name	Nama database di katalog DLF yang ditentukan dalam server eksternal.
	Table Name	Nama tabel di database DLF yang ingin Anda buatkan tabel eksternalnya.
Tabel Hologres Tujuan	Schema	Nilai default-nya adalah public. Anda dapat memilih skema lain yang memiliki izin dari daftar drop-down.
	Table Name	Nama tabel eksternal Hologres yang ingin Anda buat. Catatan Setelah Anda menentukan parameter Table Name di bagian DLF Data Source, nilai yang sama secara otomatis dimasukkan untuk parameter ini. Anda dapat mengganti nama tabel eksternal Hologres tersebut.
	Deskripsi Tabel Tujuan	Deskripsi tabel eksternal Hologres yang ingin Anda buat. Anda dapat memasukkan deskripsi kustom.

Klik Submit. Lalu, refresh panel navigasi kiri untuk melihat tabel eksternal baru di bawah skema yang sesuai.
(Opsional) Klik ganda tabel eksternal yang telah dibuat, lalu klik Query Table untuk membuka editor SQL. Anda kemudian dapat melakukan kueri terhadap data menggunakan sintaks PostgreSQL standar.

Catatan
Setelah Anda menentukan parameter Table Name di bagian DLF Data Source, semua bidang di tabel sumber eksternal akan ditampilkan. Saat membuat tabel eksternal untuk tabel sumber eksternal tersebut, semua bidang secara default disertakan dalam tabel eksternal. Jika Anda hanya ingin menyertakan bidang tertentu, atur Metode Akselerasi menjadi Single Table atau jalankan pernyataan SQL untuk membuat tabel eksternal. Untuk informasi selengkapnya tentang cara membuat tabel eksternal dengan menjalankan pernyataan SQL, lihat CREATE FOREIGN TABLE.

Operasi tambahan pada server eksternal menggunakan pernyataan SQL

Setelah server eksternal dibuat, Anda dapat menjalankan pernyataan SQL untuk melihat, memodifikasi, atau menghapus server eksternal tersebut.

Lihat server eksternal yang telah dibuat.
```
SELECT * FROM pg_foreign_server;
```

Modifikasi katalog DLF dari server eksternal.

ALTER SERVER <foreignserver_name> OPTIONS (ADD|SET|DROP dlf_catalog ['<catalog_name>']) ;

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi
foreignserver_name	Nama server eksternal yang ingin Anda modifikasi.
ADD	Operasi yang dilakukan untuk menambahkan katalog DLF ke server eksternal.
SET	Operasi yang dilakukan untuk memodifikasi katalog DLF dari server eksternal.
DROP	Operasi yang dilakukan untuk menghapus katalog DLF dari server eksternal. Contoh: `ALTER SERVER foreign_server_test OPTIONS (DROP dlf_catalog) ;`.

Hapus server eksternal.

DROP SERVER <foreignserver_name> CASCADE;

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi
foreignserver_name	Nama server eksternal yang ingin Anda hapus.
CASCADE	Operasi cascade yang dilakukan untuk menghapus objek yang bergantung pada server eksternal saat Anda menghapus server tersebut. Misalnya, tabel eksternal yang bergantung pada server eksternal tersebut akan dihapus.

Operasi tambahan pada tabel eksternal

Edit tabel eksternal

Di panel navigasi kiri HoloWeb, perluas daftar Instances Connected.
Navigasi ke instans target > database target > skema target, lalu klik Foreign Tables untuk melihat semua tabel eksternal yang telah dibuat.
Klik ganda tabel eksternal target dan klik Edit Table di halaman detail.
Anda dapat memodifikasi Fields atau Partitions yang dipetakan dari tabel sumber eksternal.
Klik Submit untuk menyimpan perubahan Anda.

Ganti nama tabel eksternal

Untuk menemukan tabel eksternal target di daftar Instances Connected di bilah navigasi kiri halaman HoloWeb, lihat Langkah 1 dan 2 di Edit a Foreign Table.
Klik kanan tabel eksternal target dan pilih Rename.
Di kotak dialog Modify Table Name, masukkan nama baru.
Klik OK.

Hapus tabel eksternal

Di bilah navigasi kiri halaman HoloWeb, temukan tabel eksternal target di daftar Instances Connected. Untuk langkah-langkah menemukan tabel tersebut, lihat langkah 1 dan 2 di Edit Foreign Table.
Klik kanan tabel eksternal target dan pilih Delete Table.
Di kotak dialog Delete Table, klik OK.

Pratinjau data

Di daftar Instances Connected di bilah navigasi kiri halaman HoloWeb, temukan tabel eksternal target dengan mengikuti langkah 1 dan 2 di Edit a foreign table.
Klik ganda tabel eksternal target. Di halaman detail yang muncul, klik tab Data Preview.

FAQ

Deskripsi masalah: Pesan error berikut muncul ketika pengguna RAM digunakan untuk mengakses tabel eksternal di HoloWeb. Pesan error tersebut menunjukkan bahwa pengguna RAM tidak memiliki izin untuk memanggil operasi API DLF. Pesan error tersebut berisi informasi berikut:
```
You are not authorized to perform the operation. Please use RAM to authorize the operation.Action: [dlf:xxx].
```
Solusi: Berikan izin AliyunDLF yang diperlukan kepada pengguna RAM untuk operasi API di konsol RAM.

Referensi

Anda juga dapat menggunakan pernyataan SQL untuk membuat server eksternal. Untuk informasi selengkapnya, lihat Buat server eksternal.
Anda juga dapat menggunakan pernyataan SQL untuk membuat tabel eksternal. Untuk informasi selengkapnya, lihat Buat tabel eksternal di instans Hologres.
Untuk informasi selengkapnya tentang pernyataan DDL untuk tabel eksternal, lihat topik-topik berikut:
- ALTER FOREIGN TABLE
- DROP FOREIGN TABLE