buat server asing, buat tabel asing - Hologres

Di Hologres, Anda dapat mengonfigurasi server asing untuk menentukan informasi koneksi sumber data eksternal seperti Bucket Object Storage Service (OSS). Selanjutnya, Anda dapat membuat tabel asing untuk mengakses dan menanyakan data lintas sistem. Topik ini menjelaskan cara menggunakan alat visualisasi HoloWeb untuk membuat server asing, mengelola tabel asing, dan melihat pratinjau data.

Prasyarat

Sebuah Bucket OSS telah dibuat dan data telah diimpor ke dalam Bucket OSS. Untuk informasi lebih lanjut, lihat Memulai dengan OSS.
Katalog Data Lake Formation (DLF) telah dibuat. Untuk informasi lebih lanjut, lihat Katalog Data.
Akun Anda diberi izin USAGE pada foreign data wrapper (FDW) yang digunakan. Untuk informasi lebih lanjut, lihat Pemberian Izin.
Sebuah basis data dan tabel sudah ada di katalog DLF dari server asing. Untuk informasi lebih lanjut tentang cara membuat basis data dan tabel, lihat Tabel Basis Data dan Fungsi.

Batasan

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

Buat server asing

Di Hologres, server asing digunakan untuk mendefinisikan informasi koneksi yang digunakan FDW untuk mengakses sumber data eksternal seperti Bucket OSS, guna akses dan query data lintas sistem. Anda juga dapat membuat pemetaan pengguna untuk mendefinisikan informasi koneksi spesifik pengguna. Untuk informasi lebih lanjut, lihat Buat server asing.

Masuk ke konsol Hologres.
Di bilah navigasi atas, pilih wilayah dari daftar drop-down.
Di panel navigasi kiri, klik Instances. Pada halaman yang muncul, temukan instans yang diinginkan dan klik Data Lake Acceleration di kolom Actions untuk mengaktifkan akselerasi danau data.
Di panel navigasi kiri konsol Hologres, klik Go to HoloWeb untuk pergi ke konsol HoloWeb.
Di konsol HoloWeb, sambungkan ke basis data yang diinginkan. Di bilah navigasi atas, klik Metadata Management.

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

Tabel berikut menjelaskan parameter.

Parameter	Deskripsi
Nama Server	Nama server asing yang ingin Anda buat. Penting Nama server asing harus unik di dalam basis data.
Titik Akhir DLF	Titik akhir DLF. Secara default, titik akhir DLF di wilayah saat ini digunakan. Untuk informasi lebih lanjut tentang wilayah dan titik akhir yang didukung oleh DLF, lihat Wilayah dan Titik Akhir yang Didukung.
Katalog DLF	Pilih katalog DLF yang telah dibuat dari daftar drop-down. Jika tidak ada katalog DLF yang dibuat, klik Create in DLF Console.
Titik Akhir OSS	Titik akhir OSS. Secara default, titik akhir OSS asli di wilayah saat ini digunakan. Anda dapat memilih titik akhir OSS-HDFS dari daftar drop-down. Jika tidak ada Bucket OSS yang dibuat, klik Create in OSS Console. Catatan Anda bisa mendapatkan titik akhir OSS dari Wilayah dan Titik Akhir. Anda bisa mendapatkan titik akhir OSS-HDFS di halaman Overview bucket tempat OSS-HDFS diaktifkan.

Klik Submit. Server asing telah dibuat.

Buat tabel asing

Masuk ke konsol Hologres.
Di bilah navigasi atas, pilih wilayah dari daftar drop-down.
Di panel navigasi kiri konsol Hologres, klik Go to HoloWeb untuk pergi ke konsol HoloWeb.
Di bilah navigasi atas, klik Metadata Management.

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

Anda dapat menentukan Seluruh Proyek, Tabel Terpilih, atau Tabel Tunggal sebagai metode akselerasi. Tabel berikut menjelaskan parameter terkait setiap metode akselerasi.

Seluruh Proyek

Kategori	Parameter	Deskripsi
Metode Akselerasi	Seluruh Proyek	Metode yang membuat tabel asing Hologres untuk semua tabel sumber di basis data yang ditentukan di DLF.
Sumber Data DLF	Nama Server	Nama server asing yang Anda buat. Parameter ini digunakan untuk menentukan informasi koneksi sumber data eksternal.
Sumber Data DLF	Nama DB	Nama basis data di katalog DLF yang ditentukan di server asing.
Lokasi Tujuan	Skema Holo	Nilai default adalah public. Anda dapat memilih skema lain yang memiliki izin dari daftar drop-down.
Pengaturan Lanjutan	Aturan Pemrosesan untuk Konflik Nama Tabel	Aturan pemrosesan jika tabel asing yang ingin Anda buat memiliki nama yang sama dengan tabel asing yang sudah ada di basis data. Nilai valid: Ignore Conflicts and Continue Creating Tables: Sistem melewati pembuatan tabel ini dan melanjutkan untuk membuat tabel lainnya. Change Table Names: Sistem memperbarui data di tabel asing yang sudah ada. Report Error and Create No Table: Sistem melaporkan pesan kesalahan dan berhenti membuat tabel.
Pengaturan Lanjutan	Aturan Pemrosesan untuk Tipe Data yang Tidak Didukung	Aturan pemrosesan jika tipe data tertentu di tabel sumber tidak didukung oleh Hologres. Nilai valid: Report Error and Stop Import: Sistem melaporkan pesan kesalahan, dan impor data gagal. Ignore and Skip Table of Unsupported Fields: Sistem melewati tabel yang berisi data dengan tipe data yang tidak didukung dan mengimpor data dari tabel lainnya.

Tabel Terpilih

Kategori	Parameter	Deskripsi
Metode Akselerasi	Tabel Terpilih	Metode yang membuat tabel asing Hologres untuk tabel sumber yang ditentukan. Anda dapat mencari tabel dengan memasukkan nama tabel di kotak pencarian untuk pencocokan kabur.
Sumber Data DLF	Nama Server	Nama server asing yang Anda buat. Parameter ini digunakan untuk menentukan informasi koneksi sumber data eksternal.
Sumber Data DLF	Nama DB	Nama basis data di katalog DLF yang ditentukan di server asing.
Lokasi Tujuan	Skema Holo	Nilai default adalah public. Anda dapat memilih skema lain yang memiliki izin dari daftar drop-down.
Pengaturan Lanjutan	Aturan Pemrosesan untuk Konflik Nama Tabel	Aturan pemrosesan jika tabel asing yang ingin Anda buat memiliki nama yang sama dengan tabel asing yang sudah ada di basis data. Nilai valid: Ignore Conflicts and Continue Creating Tables: Sistem melewati pembuatan tabel ini dan melanjutkan untuk membuat tabel lainnya. Change Table Names: Sistem memperbarui data di tabel asing yang sudah ada. Report Error and Create No Table: Sistem melaporkan pesan kesalahan dan berhenti membuat tabel.
	Aturan Pemrosesan untuk Tipe Data yang Tidak Didukung	Aturan pemrosesan jika tipe data tertentu di tabel sumber tidak didukung oleh Hologres. Nilai valid: Report Error and Stop Import: Sistem melaporkan pesan kesalahan, dan impor data gagal. Ignore and Skip Table of Unsupported Fields: Sistem melewati tabel yang berisi data dengan tipe data yang tidak didukung dan mengimpor data dari tabel lainnya.
	Cari	Melakukan pencocokan kabur untuk mencari tabel berdasarkan nama tabel dan kemudian memilih tabel.

Tabel Tunggal

Kategori	Parameter	Deskripsi
Metode Akselerasi	Tabel Tunggal	Metode yang membuat tabel asing Hologres untuk tabel sumber yang ditentukan.
Sumber Data DLF	Nama Server	Nama server asing yang Anda buat. Parameter ini digunakan untuk menentukan informasi koneksi sumber data eksternal.
	Nama DB	Nama basis data di katalog DLF yang ditentukan di server asing.
	Nama Tabel	Nama tabel di basis data DLF untuk mana Anda ingin membuat tabel asing.
Tabel Tujuan Hologres	Skema	Nilai default adalah public. Anda dapat memilih skema lain yang memiliki izin dari daftar drop-down.
	Nama Tabel	Nama tabel asing Hologres yang ingin Anda buat. Catatan Setelah Anda menentukan parameter Nama Tabel di bagian Sumber Data DLF, nilai yang sama secara otomatis dimasukkan untuk parameter ini. Anda dapat mengubah nama tabel asing Hologres.
	Deskripsi Tabel Tujuan	Deskripsi tabel asing Hologres yang ingin Anda buat. Anda dapat memasukkan deskripsi kustom.

Klik Submit. Anda dapat menyegarkan daftar instans di sebelah kiri untuk melihat tabel asing yang dibuat di skema yang Anda pilih.
Opsional. Klik dua kali nama tabel asing yang Anda buat, klik Query Table di sudut kanan atas. Di jendela query SQL, jalankan pernyataan PostgreSQL standar untuk mengembangkan data.
Catatan
Setelah Anda menentukan parameter Nama Tabel di bagian Sumber Data DLF, semua bidang di tabel sumber eksternal ditampilkan. Saat Anda membuat tabel asing untuk tabel sumber eksternal, semua bidang termasuk dalam tabel asing secara default. Jika Anda ingin menyertakan bidang tertentu di tabel asing, atur Metode Akselerasi ke Tabel Tunggal, atau jalankan pernyataan SQL untuk membuat tabel asing. Untuk informasi lebih lanjut tentang cara membuat tabel asing dengan menjalankan pernyataan SQL, lihat CREATE FOREIGN TABLE.

Operasi lebih lanjut pada server asing menggunakan pernyataan SQL

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

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

Modifikasi katalog DLF dari server asing.

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

Tabel berikut menjelaskan parameter.

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

Hapus server asing.

DROP SERVER <foreignserver_name> CASCADE;

Tabel berikut menjelaskan parameter.

Parameter	Deskripsi
foreignserver_name	Nama server asing yang ingin Anda hapus.
CASCADE	Operasi kaskade yang dilakukan untuk menghapus objek yang bergantung pada server asing saat Anda menghapus server asing. Misalnya, tabel asing yang bergantung pada server asing dihapus.

Operasi lebih lanjut pada tabel asing

Edit tabel asing

Di panel navigasi kiri konsol HoloWeb, klik Instances Connected.
Klik nama instans yang diinginkan, nama basis data yang diinginkan, lalu Foreign Tables. Semua tabel asing yang telah dibuat ditampilkan.
Klik dua kali nama tabel asing yang diinginkan. Di halaman yang muncul, klik Edit Table.
Modifikasi fields atau partitions dari tabel asing berdasarkan kebutuhan bisnis Anda.
Klik Submit.

Ganti nama tabel asing

Di panel navigasi kiri konsol HoloWeb, temukan tabel asing yang diinginkan di daftar Instances Connected dengan mengikuti Langkah 1 hingga 2 di bagian Edit tabel asing.
Klik kanan nama tabel asing dan pilih Rename.
Di kotak dialog Modify Table Name, masukkan nama baru.
Klik OK.

Hapus tabel asing

Di panel navigasi kiri konsol HoloWeb, temukan tabel asing yang diinginkan di daftar Instances Connected dengan mengikuti Langkah 1 hingga 2 di bagian Edit tabel asing.
Klik kanan nama tabel asing dan pilih Delete Table.
Di pesan Delete Table, klik OK.

Pratinjau data

Di panel navigasi kiri konsol HoloWeb, temukan tabel asing yang diinginkan di daftar Instances Connected dengan mengikuti Langkah 1 hingga 2 di bagian Edit tabel asing.
Klik dua kali nama tabel asing. Di halaman yang muncul, klik tab Data Preview.

Tanya Jawab Umum

Deskripsi masalah: Pesan kesalahan berikut muncul saat pengguna RAM digunakan untuk mengakses tabel asing di HoloWeb. Pesan kesalahan tersebut menunjukkan bahwa pengguna RAM tidak memiliki izin untuk memanggil operasi API DLF. Pesan kesalahan berisi informasi berikut:
```
Anda tidak memiliki izin untuk melakukan operasi ini. Silakan gunakan RAM untuk memberikan izin pada operasi.Action: [dlf:xxx].
```
Solusi: Berikan pengguna RAM izin terkait AliyunDLF pada operasi API DLF.

Referensi

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