Mengimpor metadata dari Oracle

Dokumen ini menjelaskan cara mengimpor metadata dari Oracle ke Knowledge Catalog (sebelumnya Dataplex Universal Catalog) menggunakan konektor Knowledge Catalog.

Konektor ini mendukung instance Oracle yang dihosting secara lokal, di Google Cloud, atau di lingkungan cloud lainnya.

Sebelum dapat mengimpor metadata dari Oracle, selesaikan tugas berikut:

  1. Berikan peran dan izin yang diperlukan.
  2. Aktifkan Knowledge Catalog dan BigQuery Data Transfer Service API.
  3. Penuhi prasyarat Oracle.
  4. Penuhi prasyarat jaringan.

Peran dan izin IAM

Untuk membuat dan mengelola tugas konektor Knowledge Catalog, Anda memerlukan peran Identity and Access Management (IAM) yang memberikan izin untuk Knowledge Catalog dan BigQuery Data Transfer Service.

Untuk mendapatkan izin yang diperlukan guna mengonfigurasi konektor Oracle, minta administrator untuk memberi Anda peran IAM berikut:

Selain itu, Anda harus memberikan izin dataplex.entryGroups.import atau peran Dataplex Entry Group Importer (roles/dataplex.entryGroupImporter) kepada agen layanan BigQuery Data Transfer Service (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com). Anda dapat memberikan peran ini di tingkat project atau tingkat grup entri.

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Mengaktifkan API

Aktifkan Knowledge Catalog dan BigQuery Data Transfer Service API.

Aktifkan API

Prasyarat Oracle

Pastikan Anda memenuhi prasyarat untuk transfer Oracle. Untuk mengetahui detailnya, lihat Prasyarat Oracle dalam dokumentasi BigQuery Data Transfer Service.

Selain prasyarat BigQuery Data Transfer Service, instance Oracle Anda harus memenuhi persyaratan berikut:

  • Versi minimum: Oracle versi 12 atau yang lebih baru diperlukan untuk mendukung atribut metadata database, seperti type dan parentContainer.

  • Hak istimewa minimum: Anda harus memberikan hak istimewa berikut kepada pengguna database:

    Izin dasar (diperlukan untuk semua konfigurasi):

    GRANT SELECT_CATALOG_ROLE TO USER_NAME;
GRANT CREATE SESSION TO USER_NAME;
GRANT SELECT ON SYS.COL$ TO USER_NAME;

    Izin untuk mengakses skema tertentu (Oracle versi 23 dan yang lebih baru):

    GRANT SELECT ANY TABLE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
GRANT EXECUTE ANY PROCEDURE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
GRANT EXECUTE ANY TYPE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
GRANT ALTER ANY TRIGGER ON SCHEMA TARGET_SCHEMA TO USER_NAME;

    Izin untuk mengakses semua skema lainnya:

    GRANT SELECT ANY TABLE TO USER_NAME;
GRANT EXECUTE ANY PROCEDURE TO USER_NAME;
GRANT EXECUTE ANY TYPE TO USER_NAME;
GRANT ALTER ANY TRIGGER TO USER_NAME;

    Ganti kode berikut:

    • USER_NAME: pengguna database yang ingin Anda konfigurasi.
    • TARGET_SCHEMA: nama skema Oracle yang ingin Anda akses.

Prasyarat jaringan

Lampiran network attachment untuk koneksi melalui Private Service Connect diperlukan saat terhubung dengan aman ke database eksternal atau sumber data cloud pihak ketiga dengan alamat IP pribadi di dalam jaringan pribadi, untuk memungkinkan BigQuery Data Transfer Service mengakses database Anda.

Jika Anda terhubung ke lingkungan lokal atau instance yang dihosting cloud menggunakan alamat IP publik, lampiran jaringan tidak diperlukan.

Mengonfigurasi konektor Oracle

  1. Di Google Cloud konsol, buka halaman Knowledge Catalog.

    Buka Knowledge Catalog

  2. Di menu navigasi, di bagian Manage, klik Connectors.

  3. Klik Add connection.

  4. Di daftar Connectors, pilih kartu Oracle.

  5. Di bagian Data source details, berikan detail koneksi untuk instance Oracle Anda:

    • Untuk Network attachment, pilih lampiran jaringan yang ada jika diperlukan, atau buat lampiran jaringan.
    • Masukkan Host, Port, Database name, Connection type, Username, dan Password.
    • Jika menggunakan TLS, pilih TLS Mode dan berikan Trusted PEM Certificate. Untuk mengetahui informasi selengkapnya, lihat Konfigurasi TLS.
    • Untuk Oracle metadata objects to import, klik Browse untuk memilih objek.

  6. Di bagian Destination settings:

    • Klik Browse dan pilih Knowledge Catalog entry group yang ada untuk menyimpan metadata yang diimpor, atau klik Create new entry group.
    • Pilih apakah akan menetapkan izin pada grup entri sekarang atau nanti. Sebaiknya tetapkan izin agar pengguna dapat melihat metadata yang diimpor. Jika Anda tidak memberikan peran Dataplex Entry Group Importer (roles/dataplex.entryGroupImporter) atau izin dataplex.entryGroups.import kepada agen layanan BigQuery Data Transfer Service (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) di tingkat project, Anda harus memberikannya di tingkat grup entri.

  7. Di bagian Connector config name, untuk Display name, masukkan nama untuk tugas impor metadata.

  8. Di bagian Schedule options, konfigurasikan frekuensi untuk tugas impor metadata. Jika Anda memilih On-demand, tugas hanya akan berjalan saat Anda memicunya secara manual.

  9. Opsional: Di bagian Notification options, konfigurasikan notifikasi email atau Pub/Sub untuk kegagalan tugas.

  10. Opsional: Di bagian Advanced options, konfigurasikan setelan enkripsi. Jika Anda memilih kunci enkripsi yang dikelola pelanggan (CMEK), perhatikan bahwa kunci tersebut digunakan untuk mengenkripsi data sementara yang dipentaskan sebelum memulai tugas impor metadata Knowledge Catalog. Kunci ini tidak digunakan untuk mengenkripsi metadata di grup entri Knowledge Catalog tujuan.

  11. Klik Save.

Setelah Anda membuat tugas, Knowledge Catalog akan menjadwalkan proses pertama sesuai dengan konfigurasi Anda, atau Anda dapat memulainya secara manual.

Langkah berikutnya