Mengimpor metadata dari SQL Server

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Knowledge Catalog (sebelumnya Dataplex Universal Catalog) memungkinkan Anda mengekstrak dan mengimpor metadata dari database SQL Server menggunakan konektor terkelola. Kemudian, Anda dapat menemukan, menelusuri, dan mengatur aset SQL Server bersama dengan sumber data lainnya dan mengambil konteks untuk model bahasa besar (LLM).

Konektor ini mendukung instance SQL Server yang dihosting secara lokal, di Cloud SQL, atau di lingkungan cloud lainnya. Untuk mengetahui informasi selengkapnya tentang cara kerja konektor, lihat Tentang konektor metadata.

Sebelum memulai

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

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

• Untuk membuat dan mengelola grup entri: Dataplex Catalog Admin (roles/dataplex.catalogAdmin), Dataplex Catalog Editor (roles/dataplex.catalogEditor), atau Dataplex Entry Group Owner (roles/dataplex.entryGroupOwner) di project.
• Untuk membuat dan mengelola tugas transfer BigQuery Data Transfer Service: BigQuery Admin (roles/bigquery.admin) di project.
• Untuk melihat log di Cloud Logging: Logs Viewer (roles/logging.viewer) di project.

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 ([e-mail]). Anda dapat memberikan peran ini di level project atau level grup entri.

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

Mengaktifkan API

Aktifkan API Knowledge Catalog dan BigQuery Data Transfer Service.

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:

• Lingkungan yang didukung: Konektor mendukung instance SQL Server yang dihosting secara lokal, di Cloud SQL, atau di lingkungan cloud lainnya.

• 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 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 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 SQL Server

Konfigurasikan konektor SQL Server menggunakan konsol Google Cloud atau API.

Konsol

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

   Buka Knowledge Catalog

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

3. Klik Tambahkan koneksi.

4. Dalam daftar Connectors, pilih kartu SQL Server.

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

   • Untuk Network attachment, pilih lampiran jaringan yang ada jika diperlukan, atau buat lampiran jaringan baru.
   • Masukkan Host, Port, Database name, Username, dan Password.
   • Jika menggunakan TLS, pilih TLS Mode dan berikan Trusted PEM Certificate.
   • Untuk SQL Server metadata objects to import, klik Browse guna 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 ([e-mail]) di level project, Anda harus memberikannya di level grup entri.

7. Di bagian Connector config name, untuk Display name, masukkan nama tampilan 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 di-stage 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 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 akan menjadwalkan operasi pertama sesuai dengan konfigurasi Anda, atau Anda dapat memulainya secara manual.

Menelusuri dan melihat metadata SQL Server

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

   Buka Penelusuran

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

3. Anda dapat menggunakan kolom penelusuran untuk menjalankan kueri penelusuran. Anda dapat melakukan penelusuran kata kunci atau bahasa alami. Misalnya, untuk melihat semua tabel SQL Server melalui penelusuran kata kunci, masukkan system=SQLSERVER 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 API LookupContext untuk mengambil konteks LLM untuk resource SQL Server tertentu.

Langkah berikutnya

• Pelajari cara Mengelola tugas konektor.