Mengimpor metadata dari SQL Server

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

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

Sebelum memulai

Sebelum Anda dapat mengimpor metadata dari SQL Server, selesaikan tugas berikut:

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

Selain itu, Anda harus memberikan izin dataplex.entryGroups.import atau peran Pengimpor Grup Entri Dataplex (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 API dan BigQuery Data Transfer Service API.

Aktifkan API

Prasyarat SQL Server

Pastikan Anda memiliki akun pengguna di database Microsoft SQL Server. Untuk mengetahui informasi selengkapnya, lihat Membuat pengguna dengan login.

Instance SQL Server Anda harus memenuhi persyaratan berikut:

  • Versi minimum: Knowledge Catalog mendukung Microsoft SQL Server versi 14 (2017) atau yang lebih baru.

  • Pengguna database: Pastikan Anda memiliki akun pengguna di database Microsoft SQL Server. Untuk mengetahui informasi selengkapnya, lihat Membuat pengguna dengan kredensial login.

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

    Izin dasar (diperlukan untuk semua konfigurasi):

    GRANT VIEW DATABASE STATE TO USER_NAME;

    Izin untuk mengakses skema tertentu:

    GRANT VIEW DEFINITION ON SCHEMA::TARGET_SCHEMA TO USER_NAME;

    Izin untuk mengakses semua skema lainnya:

    GRANT VIEW DEFINITION ON DATABASE::TARGET_DATABASE TO USER_NAME;

    Ganti kode berikut:

    • USER_NAME: pengguna database yang ingin Anda konfigurasi.
    • TARGET_SCHEMA: nama skema SQL Server yang ingin Anda akses.
    • TARGET_DATABASE: nama database SQL Server yang ingin Anda akses.

Prasyarat jaringan

Lampiran jaringan untuk koneksi melalui Private Service Connect diperlukan saat terhubung secara aman ke database eksternal atau sumber data cloud pihak ketiga dengan alamat IP pribadi di dalam jaringan pribadi, untuk mengizinkan BigQuery Data Transfer Service 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 SQL Server

Konfigurasi konektor SQL Server menggunakan Google Cloud konsol atau API.

Konsol

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

    Buka Knowledge Catalog

  2. Di menu navigasi, di bagian Kelola, klik Konektor.

  3. Klik Tambahkan koneksi.

  4. Di daftar Konektor, pilih kartu SQL Server.

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

    • Untuk Lampiran jaringan, pilih lampiran jaringan yang ada jika diperlukan, atau buat lampiran jaringan.
    • Masukkan Host, Port, Nama database, Nama pengguna, dan Sandi.
    • Jika menggunakan TLS, pilih Mode TLS dan berikan Sertifikat PEM Tepercaya.
    • Untuk Objek metadata SQL Server yang akan diimpor, klik Browse untuk memilih objek.

  6. Di bagian Setelan tujuan:

    • Klik Jelajahi dan pilih grup entri Knowledge Catalog yang ada untuk menyimpan metadata yang diimpor, atau klik Buat grup entri baru.
    • 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 Sesuai permintaan, tugas hanya berjalan saat Anda memicunya secara manual.

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

  10. Opsional: Di bagian Advanced options, konfigurasi setelan enkripsi. Jika Anda memilih kunci enkripsi yang dikelola pelanggan (CMEK), perhatikan bahwa kunci tersebut digunakan untuk mengenkripsi data sementara yang dipersiapkan sebelum memulai tugas impor metadata Knowledge Catalog. Tidak digunakan untuk mengenkripsi metadata dalam grup entri Knowledge Catalog tujuan.

  11. Klik Simpan.

REST

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

  • Tetapkan kolom dataSourceId ke "sqlserver".
  • Di kolom metadataDestination, isi objek dataplexConfiguration 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 menjadwalkan tugas pertama sesuai dengan konfigurasi Anda, atau Anda dapat memulainya secara manual.

Langkah berikutnya