Buat Foreign Server, buat tabel eksternal - Hologres

Di Hologres, konfigurasikan Foreign Server untuk menentukan detail koneksi ke sumber data eksternal seperti Object Storage Service (OSS). Hal ini memungkinkan Anda membuat tabel eksternal dan melakukan kueri data lintas sistem. Topik ini menjelaskan cara menggunakan alat visual HoloWeb untuk membuat Foreign Server, mengelola tabel eksternal, dan melihat pratinjau data.

Prasyarat

Buat Bucket OSS dan impor data. Untuk informasi selengkapnya, lihat Quick Start.
Katalog DLF telah dibuat. Untuk informasi selengkapnya, lihat data catalog.
Memiliki izin USAGE untuk foreign-data wrapper yang akan digunakan. Untuk instruksi otorisasi, lihat Grant permissions.
Katalog DLF yang digunakan oleh Foreign Server Anda harus sudah berisi database dan tabel. Untuk langkah-langkah pembuatannya, lihat Databases, tables, and functions.

Batasan

Hologres tidak mendukung kueri lintas wilayah pada data tabel eksternal.

Buat Foreign Server

Di Hologres, Foreign Server menentukan detail koneksi untuk mengakses sumber data eksternal—seperti Object Storage Service (OSS)—melalui foreign-data wrapper. Hal ini memungkinkan akses dan kueri data lintas sistem. Anda juga dapat menggunakan user mapping untuk menentukan detail koneksi bagi pengguna tertentu. Untuk informasi selengkapnya, lihat Create a Foreign Server.

Login ke Hologres Management Console.
Pada bilah menu atas, pilih wilayah yang sesuai di sebelah kiri.
Pada panel navigasi kiri, pilih Instances. Klik Data Lake Acceleration pada kolom Actions instans target Anda untuk mengaktifkan akselerasi data lake.
Klik Go to HoloWeb untuk membuka halaman pengembangan HoloWeb.
Setelah login ke database target Anda, klik Metadata Management pada bilah menu atas.

Pada halaman Metadata Management, klik OSS Data Lake Acceleration > Create Foreign Server.

Deskripsi parameter sebagai berikut:

Parameter	Deskripsi
Nama Server	Nama Foreign Server. Penting Nama Foreign Server harus unik dalam database.
Titik Akhir DLF	Default ke endpoint DLF untuk wilayah saat ini. Untuk informasi selengkapnya, lihat Supported regions and endpoints.
Katalog DLF	Pilih katalog DLF yang sudah ada dari daftar drop-down. Jika daftar kosong, klik Create in DLF Console.
Titik Akhir OSS	Default ke endpoint OSS native untuk wilayah saat ini. Untuk menggunakan endpoint OSS-HDFS, pilih dari daftar drop-down. Jika Anda belum membuat Bucket OSS, klik Create in OSS Console. Catatan OSS Endpoint: Dapatkan dari Regions and endpoints. OSS-HDFS Endpoint: Temukan di halaman Overview Bucket OSS mana pun tempat OSS-HDFS diaktifkan.

Klik Submit untuk menyelesaikan pembuatan Foreign Server.

Buat tabel asing

Login ke Hologres Management Console.
Dari sisi kiri bilah menu atas, pilih wilayah.
Klik Go to HoloWeb untuk membuka halaman pengembangan HoloWeb.
Pada bilah menu atas HoloWeb, klik Metadata Management.

Pada halaman Metadata Management, klik OSS Data Lake Acceleration > Create Foreign Table.

Pilih salah satu mode akselerasi berikut sesuai kebutuhan: Entire Database Acceleration, Partial Acceleration, atau Single Table Acceleration. Deskripsi parameter sebagai berikut:

Entire Database Acceleration

Kategori	Nama Parameter	Deskripsi
Acceleration Mode	Entire Database Acceleration	Membuat semua tabel di bawah database DLF yang ditentukan sebagai tabel eksternal Hologres.
Sumber Data DLF	Nama Server	Foreign Server yang sudah ada yang menentukan detail koneksi ke sumber data eksternal.
Sumber Data DLF	Nama DB	Nama database di bawah katalog DLF yang ditentukan dalam Foreign Server.
Target Location	Skema Holo	Default ke public. Pilih skema lain dengan izin yang sesuai dari daftar drop-down.
Advanced Options	Table Name Conflict	Jika tabel dengan nama yang sama sudah ada saat pembuatan, pilih salah satu tindakan berikut: Ignore and continue creating other tables: Lewati tabel saat ini dan lanjutkan dengan tabel lainnya. Update and modify the existing table: Perbarui data di tabel yang sudah ada. Error and stop duplicate creation: Kembalikan error dan hentikan pembuatan lebih lanjut.
Advanced Options	Unsupported Data Type	Jika terdapat tipe data yang tidak didukung saat pembuatan tabel, pilih salah satu tindakan berikut: Error and fail import: Kembalikan error dan gagalkan impor. Ignore and Skip Table of Unsupported Fields: Lewati tabel dengan bidang yang tidak didukung dan lanjutkan impor.

Partial Acceleration

Category	Parameter Name	Description
Acceleration Mode	Partial Acceleration	Pilih tabel tertentu untuk dibuat sebagai foreign tables. Gunakan pencarian fuzzy berdasarkan nama tabel.
DLF Data Source	Server Name	Foreign Server yang sudah ada yang mendefinisikan detail koneksi untuk sumber data eksternal.
DLF Data Source	DB Name	Nama database di bawah katalog DLF yang ditentukan dalam Foreign Server.
Target Location	Holo Schema	Default-nya adalah public. Pilih skema lain dengan izin yang sesuai dari daftar drop-down.
Advanced Options	Table Name Conflict	Jika tabel dengan nama yang sama sudah ada saat pembuatan, pilih salah satu aksi berikut: Ignore and continue creating other tables: Lewati tabel saat ini dan lanjutkan dengan tabel lainnya. Update and modify the existing table: Perbarui data pada tabel yang sudah ada. Error and stop duplicate creation: Kembalikan error dan hentikan pembuatan lebih lanjut.
	Unsupported Data Type	Jika terdapat tipe data yang tidak didukung saat pembuatan tabel, pilih salah satu aksi berikut: Error and fail import: Kembalikan error dan gagalkan impor. Ignore and Skip Table of Unsupported Fields: Lewati tabel yang memiliki bidang tidak didukung dan lanjutkan impor.
	Search	Gunakan pencarian fuzzy berdasarkan nama tabel untuk menemukan dan memilih tabel target.

Single Table Acceleration

Kategori	Nama Parameter	Deskripsi
Acceleration Mode	Single Table Acceleration	Membuat tabel eksternal Hologres untuk satu tabel tertentu.
Sumber Data DLF	Nama Server	Foreign Server yang sudah ada yang menentukan detail koneksi ke sumber data eksternal.
	Nama DB	Nama database di bawah katalog DLF yang ditentukan dalam Foreign Server.
	Nama Tabel	Nama tabel yang dibuat di database DLF.
Hologres Target Table	Skema	Default ke public. Pilih skema lain dengan izin yang sesuai dari daftar drop-down.
	Nama Tabel	Nama tabel eksternal Hologres baru. Catatan Setelah memasukkan nama tabel DLF target, sistem akan mengisinya secara otomatis. Ubah nama jika diperlukan.
	Target Table Description	Deskripsi kustom untuk tabel eksternal Hologres baru.

Klik Submit. Tabel eksternal baru muncul di bawah skema yang sesuai di sebelah kiri setelah refresh.
(Opsional) Klik ganda tabel eksternal yang dibuat, lalu klik Query Table untuk membuka jendela kueri SQL dan mengembangkan menggunakan sintaks PostgreSQL standar.

Catatan
Setelah memasukkan nama tabel, semua bidang dari tabel sumber eksternal akan muncul. Secara default, semua bidang dibuat di tabel eksternal. Untuk membuat hanya bidang tertentu, gunakan Single Table Acceleration atau pernyataan SQL. Untuk pembuatan tabel eksternal berbasis SQL, lihat CREATE FOREIGN TABLE.

Operasi tambahan Foreign Server (metode SQL)

Setelah berhasil dibuat, gunakan pernyataan SQL untuk melihat, memodifikasi, atau menghapus Foreign Server Anda. Sintaks sebagai berikut:

Lihat Foreign Server yang telah dibuat
```
SELECT * FROM pg_foreign_server;
```

Modifikasi katalog DLF dari Foreign Server

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

Deskripsi parameter sebagai berikut:

Parameter	Deskripsi
foreignserver_name	Nama Foreign Server yang akan dimodifikasi.
ADD	Tambahkan katalog DLF ke Foreign Server.
SET	Modifikasi katalog DLF dari Foreign Server.
DROP	Hapus katalog DLF dari Foreign Server. Contoh: `ALTER SERVER foreign_server_test OPTIONS (DROP dlf_catalog) ;`.

Hapus Foreign Server
```
DROP SERVER <foreignserver_name> CASCADE;
```
Deskripsi parameter sebagai berikut:

Parameter
Deskripsi

foreignserver_name

Nama Foreign Server yang akan dihapus.

CASCADE

Saat menghapus Foreign Server, hapus juga objek dependen seperti tabel eksternal.

Operasi Tambahan pada Tabel Eksternal

Edit tabel asing

Pada panel navigasi kiri halaman HoloWeb, pilih daftar Logged-in Instances.
Klik Instans Target > Database Target > Skema Target, lalu klik Foreign Tables untuk melihat semua tabel eksternal yang telah dibuat.
Klik ganda tabel eksternal target, lalu klik Edit Table pada halaman detail.
Modifikasi Fields atau Partitions yang dipetakan dari tabel sumber eksternal sesuai kebutuhan.
Klik Submit untuk menyimpan perubahan pada tabel eksternal.

Ganti nama tabel asing

Pada daftar Logged-in Instances di panel navigasi kiri HoloWeb, temukan tabel eksternal target Anda. Untuk langkah-langkahnya, lihat langkah 1–2 di Edit a foreign table.
Klik kanan tabel eksternal target dan pilih Rename.
Pada kotak dialog Modify Table Name, masukkan nama baru.
Klik OK.

Hapus tabel asing

Pada daftar Logged-in Instances di panel navigasi kiri HoloWeb, temukan tabel eksternal target Anda. Untuk langkah-langkahnya, lihat langkah 1–2 di Edit a foreign table.
Klik kanan tabel eksternal target dan pilih Delete Table.
Pada kotak dialog Delete Table, klik OK.

Pratinjau data

Pada daftar Logged-in Instances di panel navigasi kiri HoloWeb, temukan tabel eksternal target Anda. Untuk langkah-langkahnya, lihat langkah 1–2 di Edit a foreign table.
Klik ganda tabel eksternal target, lalu klik Data Preview pada halaman detail tabel eksternal.

Tanya Jawab Umum

Masalah: Saat mengakses tabel eksternal di HoloWeb, Anda menerima error izin API RAM DLF. Pesan error mencakup:

Anda tidak memiliki izin untuk melakukan operasi ini. Silakan gunakan RAM untuk memberikan izin pada operasi.Action: [dlf:xxx].

Solusi: Berikan izin OpenAPI terkait AliyunDLF di RAM.

Referensi

Anda juga dapat membuat Foreign Server menggunakan SQL. Untuk informasi selengkapnya, lihat Create a Foreign Server.
Anda juga dapat membuat tabel eksternal menggunakan SQL. Untuk informasi selengkapnya, lihat Create a foreign table in a Hologres instance.
Untuk detail lebih lanjut tentang pernyataan DDL tabel eksternal, lihat:
- ALTER FOREIGN TABLE
- DROP FOREIGN TABLE