Mengimpor metadata dari MySQL

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

Konektor ini mendukung instance MySQL yang dihosting di infrastruktur lokal, di Cloud SQL, atau di lingkungan cloud lainnya.

Sebelum dapat mengimpor metadata dari MySQL, selesaikan tugas berikut:

  1. Berikan peran dan izin yang diperlukan.
  2. Aktifkan Knowledge Catalog dan BigQuery Data Transfer Service API.
  3. Penuhi prasyarat MySQL.
  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 MySQL, minta administrator untuk memberi Anda peran IAM berikut:

Selain itu, Anda harus memberikan izin (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) atau peran Dataplex Entry Group Importer (roles/dataplex.entryGroupImporter) kepada agen layanan BigQuery Data Transfer Service dataplex.entryGroups.import. 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 MySQL

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

Selain prasyarat BigQuery Data Transfer Service, database MySQL Anda harus memenuhi persyaratan berikut untuk ekstraksi metadata:

  • Versi minimum: MySQL versi 8.0 atau yang lebih baru.
  • Izin minimum yang diperlukan: Alat ekstraksi memerlukan izin tertentu untuk berhasil membuat kueri INFORMATION_SCHEMA dan mengumpulkan metadata.

Izin ini memastikan cakupan metadata berikut:

  • Informasi instance dan database: Konfigurasi nama host, port, versi, dan skema.
  • Tabel dan kolom: Struktur inti, jenis data, dan metadata operasional, seperti ukuran dan jumlah baris.
  • Indeks dan partisi: Indeks sekunder, metode partisi, dan ekspresi.
  • Tampilan: Struktur dan definisi tabel virtual.
  • Rutinitas: Prosedur tersimpan, fungsi, dan parameternya.
  • Batasan: Kunci utama, kunci asing, batasan unik, dan batasan pemeriksaan yang mendetail.
  • Pemicu: Definisi pemicu dan waktu peristiwa.

Untuk memberikan izin ini, jalankan skrip SQL berikut.

  1. Buat pengguna:

    CREATE USER 'USERNAME'@'%'
IDENTIFIED BY 'PASSWORD';

  2. Berikan akses metadata. Anda dapat memberikan akses untuk satu database target atau di semua database pada instance.

    Untuk memberikan akses bagi satu database atau skema target:

    GRANT SELECT, SHOW VIEW, REFERENCES, EXECUTE, TRIGGER
ON DATABASE_NAME.*
TO 'USERNAME'@'%';

    Atau, untuk memberikan akses di semua database pada instance:

    GRANT SELECT, SHOW VIEW, REFERENCES, EXECUTE, TRIGGER
ON *.*
TO 'USERNAME'@'%';

  3. Izinkan alat ekstraksi untuk mencantumkan semua database yang tersedia di instance:

    GRANT SHOW DATABASES ON *.* TO 'USERNAME'@'%';

  4. Terapkan perubahan:

    FLUSH PRIVILEGES;

Ganti kode berikut:

  • USERNAME: pengguna database yang ingin Anda konfigurasi.
  • PASSWORD: sandi untuk pengguna database.
  • DATABASE_NAME: nama database MySQL 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, agar BigQuery Data Transfer Service dapat mengakses database Anda.

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

Mengonfigurasi konektor MySQL

Konfigurasikan konektor MySQL menggunakan Google Cloud konsol atau API.

Konsol

  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 MySQL.

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

    • Untuk Network attachment, pilih lampiran jaringan yang ada jika diperlukan, atau buat lampiran jaringan.
    • Masukkan Host, Port, Database name, Username, dan Password.
    • Jika menggunakan TLS, pilih TLS Mode dan berikan Trusted PEM Certificate.
    • Untuk MySQL 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. 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 agent (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 Simpan.

REST

Gunakan projects.locations.transferConfigs.create metode. Di TransferConfig resource, konfigurasikan kolom berikut:

  • Tetapkan kolom dataSourceId ke "mysql".
  • Di kolom metadataDestination, isi dataplexConfiguration objek dengan jalur resource grup entri Knowledge Catalog target: projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>

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

Menelusuri dan melihat metadata MySQL

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

    Buka Penelusuran

  2. Di panel Filters, Anda dapat memfilter aset MySQL menggunakan Project, System, dan bagian Type aliases. Di bagian System, pilih Imported Context. Memilih filter ini akan membuka sub-bagian Managed Connectors. Pilih MySQL untuk memfilter semua metadata MySQL.

  3. Anda dapat menggunakan kolom penelusuran untuk melakukan kueri penelusuran. Anda dapat melakukan penelusuran kata kunci atau bahasa natural. Misalnya, untuk melihat semua tabel MySQL melalui penelusuran kata kunci, masukkan system=MYSQL AND type=TABLE.

    Untuk mempelajari lebih lanjut cara menelusuri resource, lihat Menelusuri resource di Knowledge Catalog. Untuk mempelajari lebih lanjut ekspresi yang dapat Anda gunakan di kolom penelusuran, lihat Sintaksis penelusuran untuk Knowledge Catalog.

  4. Anda juga dapat menggunakan LookupContext API untuk mengambil konteks LLM untuk resource MySQL tertentu.

Langkah berikutnya