Importa metadati da SQL Server

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questo documento descrive come importare i metadati da SQL Server in Knowledge Catalog (in precedenza Dataplex Universal Catalog) utilizzando un connettore Knowledge Catalog.

Questo connettore supporta le istanze di SQL Server ospitate on-premise, in Cloud SQL o in altri ambienti cloud.

Prima di iniziare

Prima di poter importare i metadati da SQL Server, completa le seguenti attività:

1. Concedi i ruoli e le autorizzazioni richiesti.
2. Abilita le API Knowledge Catalog e BigQuery Data Transfer Service.
3. Soddisfa i prerequisiti di SQL Server.
4. Soddisfare i prerequisiti di rete.

Ruoli e autorizzazioni IAM

Per creare e gestire un job del connettore Knowledge Catalog, devi disporre dei ruoli Identity and Access Management (IAM) che concedono le autorizzazioni per Knowledge Catalog e BigQuery Data Transfer Service.

Per ottenere le autorizzazioni necessarie per configurare un connettore SQL Server, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Per creare e gestire i gruppi di voci: Dataplex Catalog Admin (roles/dataplex.catalogAdmin), Dataplex Catalog Editor (roles/dataplex.catalogEditor) o Dataplex Entry Group Owner (roles/dataplex.entryGroupOwner) nel progetto.
• Per creare e gestire i job di trasferimento BigQuery Data Transfer Service: Amministratore BigQuery (roles/bigquery.admin) nel progetto.
• Per visualizzare i log in Cloud Logging: Logs Viewer (roles/logging.viewer) nel progetto.

Inoltre, devi concedere all'agente di servizio BigQuery Data Transfer Service ([e-mail]) l'autorizzazione dataplex.entryGroups.import o il ruolo Importatore gruppi di voci Dataplex (roles/dataplex.entryGroupImporter). Puoi concedere questo ruolo a livello di progetto o di gruppo di voci.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso.

Abilita API

Abilita le API Knowledge Catalog e BigQuery Data Transfer Service.

Abilita le API

Prerequisiti di SQL Server

Assicurati di avere un account utente nel database Microsoft SQL Server. Per saperne di più, consulta Creare un utente con un accesso.

La tua istanza SQL Server deve soddisfare i seguenti requisiti:

• Versione minima:Knowledge Catalog supporta Microsoft SQL Server versione 14 (2017) o successive.

• Utente del database:assicurati di avere un account utente nel database Microsoft SQL Server. Per saperne di più, consulta Creare un utente con un accesso.

• Privilegi minimi:devi concedere i seguenti privilegi all'utente del database:

  Autorizzazioni di base (obbligatorie per tutte le configurazioni):

  GRANT VIEW DATABASE STATE TO USER_NAME;
  

  Autorizzazioni per accedere a uno schema specifico:

  GRANT VIEW DEFINITION ON SCHEMA::TARGET_SCHEMA TO USER_NAME;
  

  Autorizzazioni per accedere a tutti gli altri schemi:

  GRANT VIEW DEFINITION ON DATABASE::TARGET_DATABASE TO USER_NAME;
  

  Sostituisci quanto segue:

  • USER_NAME: l'utente del database che vuoi configurare.
  • TARGET_SCHEMA: il nome dello schema SQL Server a cui vuoi accedere.
  • TARGET_DATABASE: il nome del database SQL Server a cui vuoi accedere.

Prerequisiti di networking

Per la connessione tramite Private Service Connect è necessario un collegamento di rete quando ci si connette in modo sicuro a database esterni o origini dati cloud di terze parti con un indirizzo IP privato all'interno di una rete privata, per consentire a BigQuery Data Transfer Service di accedere al tuo database.

Se ti connetti a un ambiente on-premise o a un'istanza ospitata sul cloud utilizzando un indirizzo IP pubblico, non è necessario un collegamento di rete.

Configura un connettore SQL Server

Configura un connettore SQL Server utilizzando la console Google Cloud o l'API.

Console

1. Nella console Google Cloud , vai alla pagina Knowledge Catalog.

   Vai a Knowledge Catalog

2. Nel menu di navigazione, nella sezione Gestisci, fai clic su Connettori.

3. Fai clic su Aggiungi connessione.

4. Nell'elenco Connettori, seleziona la scheda SQL Server.

5. Nella sezione Dettagli origine dati, fornisci i dettagli di connessione per l'istanza di SQL Server:

   • Per Collegamento di rete, seleziona un collegamento di rete esistente, se necessario, o creane uno.
   • Inserisci Host, Porta, Nome database, Nome utente e Password.
   • Se utilizzi TLS, seleziona una modalità TLS e fornisci un certificato PEM attendibile.
   • Per Oggetti di metadati di SQL Server da importare, fai clic su Sfoglia per selezionare gli oggetti.

6. Nella sezione Impostazioni destinazione:

   • Fai clic su Sfoglia e seleziona un gruppo di voci di Knowledge Catalog esistente in cui archiviare i metadati importati oppure fai clic su Crea nuovo gruppo di voci.
   • Scegli se impostare le autorizzazioni per il gruppo di voci ora o in un secondo momento. Ti consigliamo di impostare le autorizzazioni in modo che gli utenti possano visualizzare i metadati importati. Se non hai concesso il ruolo Importatore gruppi di voci Dataplex (roles/dataplex.entryGroupImporter) o l'autorizzazione dataplex.entryGroups.import all'agente di servizio BigQuery Data Transfer Service ([e-mail]) a livello di progetto, devi concederlo a livello di gruppo di voci.

7. Nella sezione Nome configurazione connettore, per Nome visualizzato, inserisci un nome per il job di importazione dei metadati.

8. Nella sezione Opzioni di pianificazione, configura la frequenza per il job di importazione dei metadati. Se selezioni On demand, il job viene eseguito solo quando lo attivi manualmente.

9. (Facoltativo) Nella sezione Opzioni di notifica, configura le notifiche via email o Pub/Sub per gli errori dei job.

10. (Facoltativo) Nella sezione Opzioni avanzate, configura le impostazioni di crittografia. Se selezioni una chiave di crittografia gestita dal cliente (CMEK), tieni presente che la chiave viene utilizzata per criptare tutti i dati temporanei preparati prima di avviare i job di importazione dei metadati di Knowledge Catalog. Non viene utilizzato per criptare i metadati nel gruppo di voci Knowledge Catalog di destinazione.

11. Fai clic su Salva.

REST

Utilizza il metodo projects.locations.transferConfigs.create. Nella risorsa TransferConfig, configura i seguenti campi:

• Imposta il campo dataSourceId su "sqlserver".
• Nel campo metadataDestination, compila l'oggetto dataplexConfiguration con il percorso della risorsa del gruppo di voci di Knowledge Catalog di destinazione: projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>

Dopo aver creato il job, Knowledge Catalog pianifica la prima esecuzione in base alla configurazione oppure puoi avviarla manualmente.

Cerca e visualizza i metadati di SQL Server

1. Nella console Google Cloud , vai alla pagina Knowledge Catalog Search.

   Vai a Cerca

2. Nel riquadro Filtri, puoi filtrare gli asset SQL Server utilizzando le sezioni Progetto, Sistema e Alias di tipo. Nella sezione System (Sistema), seleziona Imported Context (Contesto importato). Se selezioni questo filtro, si apre una sottosezione Connettori gestiti. Seleziona SQL Server per filtrare tutti i metadati di SQL Server.

3. Puoi utilizzare il campo di ricerca per eseguire query di ricerca. Puoi eseguire una ricerca per parola chiave o in linguaggio naturale. Ad esempio, per visualizzare tutte le tabelle SQL Server tramite la ricerca per parola chiave, inserisci system=SQLSERVER AND type=TABLE.

   Per saperne di più sulla ricerca delle risorse, consulta Cercare risorse in Knowledge Catalog. Per scoprire di più sulle espressioni che puoi utilizzare nel campo di ricerca, consulta Sintassi di ricerca per Knowledge Catalog.

4. Puoi anche utilizzare l'API LookupContext per recuperare il contesto LLM per risorse SQL Server specifiche.

Passaggi successivi

• Scopri come gestire i job del connettore.