Richiedi modifiche ai metadati con i workflow di governance

Questo documento descrive come proporre modifiche a singole risorse per le categorie e i termini del glossario aziendale, nonché per le voci di Knowledge Catalog (in precedenza Dataplex Universal Catalog), utilizzando i workflow di governance.

Prima di iniziare

Per utilizzare i workflow di governance per le modifiche ai metadati, assicurati di aver abilitato le API richieste e di disporre dei ruoli e delle autorizzazioni di Identity and Access Management (IAM) necessari.

Abilita l'API Dataplex, se non è già abilitata.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

Abilitare l'API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per richiedere modifiche ai metadati, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto, nel glossario o nel gruppo di voci:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più su ruoli e autorizzazioni, consulta Ruoli IAM di Knowledge Catalog.

Richiedi modifiche per una categoria del glossario

Se non disponi dell'accesso in scrittura diretto per creare, aggiornare o eliminare una categoria del glossario, puoi richiedere questa modifica utilizzando i workflow di governance. Dopo l'invio di una richiesta di modifica dei metadati, i richiedenti, gli approvatori e gli amministratori del workflow possono monitorare e gestire la richiesta durante tutto il suo ciclo di vita.

Crea una categoria

Console

Per richiedere una categoria:

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

    Vai a Glossari

  2. Seleziona il glossario in cui vuoi creare una categoria, quindi fai clic su Crea categoria.

  3. Inserisci un Nome visualizzato per la categoria.

  4. (Facoltativo) Nella sezione Etichette, aggiungi le etichette per il glossario.

  5. (Facoltativo) Nella sezione Motivazione, fornisci all'approvatore un motivo per la modifica.

  6. Nella sezione Impostazioni avanzate, puoi modificare l'ID categoria se vuoi cambiare l'ID generato automaticamente.

  7. Fai clic su Invia per la revisione.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere la creazione di una categoria, utilizza il metodo glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createCategoryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "categoryId": "sample-category-id",
      "category": {
        "displayName": "Sample category name",
        "description": "Sample category description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui si trova il glossario, ad esempio us-central1.
  • GLOSSARY_ID: l'ID del glossario principale.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Aggiorna una categoria

Console

Per suggerire modifiche a una categoria:

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

    Vai a Glossari

  2. Seleziona il glossario che include la categoria che vuoi aggiornare.

  3. Fai clic sul nome della categoria per aprire il riquadro Dettagli categoria.

  4. Per aggiungere o aggiornare i dettagli della categoria, fai clic su Aggiungi o Modifica accanto alla sezione che vuoi aggiornare.

  5. Fai clic su Invia per la revisione. Alcuni elementi potrebbero richiedere una motivazione aggiuntiva per la modifica. Fornisci la giustificazione e fai clic su Procedi all'invio delle modifiche.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere un aggiornamento del nome visualizzato e della descrizione di una categoria, utilizza il metodo glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateCategoryRequest": {
      "category": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui si trova il glossario, ad esempio us-central1.
  • GLOSSARY_ID: l'ID del glossario principale.
  • CATEGORY_ID: l'ID della categoria di destinazione che vuoi aggiornare.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Elimina una categoria

Console

Per richiedere l'eliminazione di una categoria, segui questi passaggi:

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

    Vai a Glossari

  2. Espandi il glossario e fai clic sulla categoria che vuoi eliminare.

  3. Nel riquadro Dettagli categoria, seleziona Elimina dal menu.

  4. (Facoltativo) Nella sezione Motivazione, fornisci all'approvatore il motivo della modifica.

  5. Fai clic su Invia per la revisione.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere l'eliminazione di una categoria, utilizza il metodo glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteCategoryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/categories/CATEGORY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui si trova il glossario, ad esempio us-central1.
  • GLOSSARY_ID: l'ID del glossario principale.
  • CATEGORY_ID: l'ID della categoria di destinazione che vuoi eliminare.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Richiedi modifiche per un termine del glossario

Se non disponi dell'accesso in scrittura diretto per creare, aggiornare o eliminare un termine del glossario, puoi richiedere questa modifica utilizzando i workflow di governance.

Crea un termine del glossario

Console

Per richiedere la creazione di un termine del glossario:

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

    Vai a Glossari

  2. Seleziona il glossario o la categoria in cui vuoi creare un termine per aprire il riquadro dei dettagli.

    • Se crei un termine dalla pagina dei dettagli del glossario, seleziona Crea termine dal menu.
    • Se crei un termine dalla pagina dei dettagli della categoria, seleziona Aggiungi termine dal menu.

  3. Inserisci un Nome visualizzato per la categoria.

  4. (Facoltativo) Nella sezione Etichette, aggiungi etichette per il termine.

  5. (Facoltativo) Nella sezione Motivazione, fornisci all'approvatore un motivo per la modifica.

  6. Nella sezione Impostazioni avanzate, puoi modificare l'ID termine se vuoi cambiare l'ID generato automaticamente.

  7. Fai clic su Invia per la revisione.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere la creazione di un termine del glossario, utilizza il metodo glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "createTermRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
      "termId": "sample-term-id",
      "term": {
        "displayName": "Sample term name",
        "description": "Sample term description",
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID"
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui si trova il glossario, ad esempio us-central1.
  • GLOSSARY_ID: l'ID del glossario principale.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Aggiorna un termine di glossario

Console

Per richiedere modifiche a un termine del glossario:

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

    Vai a Glossari

  2. Seleziona il glossario che include il termine da aggiornare.

  3. Fai clic sul nome del termine per aprire il riquadro Dettagli termine.

  4. Aggiungi o aggiorna i dettagli del termine facendo clic su Aggiungi o Modifica accanto alla sezione che vuoi aggiornare.

  5. Fai clic su Invia per la revisione. Alcune sezioni potrebbero richiedere di fornire una motivazione aggiuntiva prima di poter inviare la richiesta. Fornisci la giustificazione e fai clic su Procedi all'invio delle modifiche.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere un aggiornamento del nome visualizzato e della descrizione di un termine del glossario, utilizza il metodo glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "updateTermRequest": {
      "term": {
        "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID",
        "displayName": "Sample new name",
        "description": "Sample new description"
      },
      "updateMask": {
        "paths": [
          "display_name",
          "description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui si trova il glossario, ad esempio us-central1.
  • GLOSSARY_ID: l'ID del glossario principale.
  • TERM_ID: l'ID del termine di destinazione che vuoi aggiornare.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Elimina un termine di glossario

Console

Per richiedere l'eliminazione di un termine, segui questi passaggi:

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

    Vai a Glossari

  2. Seleziona il glossario che include il termine che vuoi eliminare.

  3. Fai clic sul nome del termine per aprire il riquadro Dettagli termine.

  4. Fai clic su Elimina.

  5. Fai clic su Invia per la revisione. Alcune sezioni potrebbero richiedere di fornire una motivazione aggiuntiva prima di poter inviare la richiesta. Fornisci la giustificazione e fai clic su Procedi all'invio delle modifiche.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere l'eliminazione di un termine del glossario, utilizza il metodo glossaries.requestGlossaryChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID",
    "deleteTermRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID/terms/TERM_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID:requestGlossaryChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui si trova il glossario, ad esempio us-central1.
  • GLOSSARY_ID: l'ID del glossario principale.
  • TERM_ID: l'ID del termine di destinazione che vuoi eliminare.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce un RequestGlossaryChangeResponse che contiene il nome della risorsa di ChangeRequest.Il sistema registra un nuovo log di sistema per la richiesta di modifica e invia una notifica all'approvatore.

Richiedi modifiche per una voce

Se non disponi dell'accesso in scrittura diretto per creare, modificare o eliminare una voce di Knowledge Catalog, puoi richiedere questa modifica utilizzando i flussi di lavoro di governance.

Crea una voce

Console

Per richiedere la creazione di una voce:

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

    Vai a Tipi di metadati

  2. Fai clic sulla scheda Gruppi di voci.

  3. Seleziona il gruppo di voci in cui vuoi creare una voce, quindi fai clic su Crea voce.

  4. Inserisci un ID e un nome visualizzato per la voce.

  5. Seleziona un tipo di voce.

  6. (Facoltativo) Fornisci i dettagli dell'aspetto o aggiungi una descrizione.

  7. Fai clic su Invia per la revisione. Alcune sezioni potrebbero richiedere di fornire una motivazione aggiuntiva prima di poter inviare la richiesta. Fornisci la giustificazione e fai clic su Procedi all'invio delle modifiche.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere la creazione di una voce, utilizza il metodo entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryId": "sample-entry-id",
      "entry": {
        "entryType": "projects/PROJECT_ID/locations/LOCATION/entryTypes/ENTRY_TYPE_ID",
        "entrySource": {
          "displayName": "Sample entry name",
          "description": "Sample entry description"
        }
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui esiste il gruppo di voci, ad esempio us-central1.
  • ENTRY_GROUP_ID: l'ID del gruppo di voci padre.
  • ENTRY_TYPE_ID: l'ID del tipo di voce.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Aggiorna una voce

Console

Per richiedere aggiornamenti per una voce:

  1. Nella console Google Cloud , vai alla pagina Ricerca o Catalogo di Knowledge Catalog.

Vai alla Ricerca

  1. Cerca e seleziona la voce che vuoi aggiornare.
  2. Fai clic sulla voce per aprire la pagina Dettagli voce.
  3. Fai clic su Aggiungi accanto alla sezione che vuoi aggiornare.
  4. Aggiorna la sezione.
  5. Fai clic su Invia per la revisione. Alcune sezioni potrebbero richiedere di fornire una motivazione aggiuntiva prima di poter inviare la richiesta. Fornisci la giustificazione e fai clic su Procedi all'invio delle modifiche.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Flussi di lavoro di governance nella scheda Le mie richieste.

REST

Per richiedere un aggiornamento del nome visualizzato e della descrizione di un'origine di voci, utilizza il metodo entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "entrySource": {
          "displayName": "Sample new name",
          "description": "Sample new description"
        }
      },
      "updateMask": {
        "paths": [
          "entry_source.display_name",
          "entry_source.description"
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui esiste il gruppo di voci, ad esempio us-central1.
  • ENTRY_GROUP_ID: l'ID del gruppo di voci padre.
  • ENTRY_ID: l'ID della voce di destinazione.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Elimina una voce

Console

Per richiedere l'eliminazione di una voce:

  1. Nella console Google Cloud , vai alla pagina Ricerca o Catalogo di Knowledge Catalog.

Vai alla Ricerca

  1. Cerca e seleziona la voce che vuoi eliminare.
  2. Fai clic sulla voce per aprire la pagina Dettagli voce.
  3. Fai clic su Elimina.
  4. Fai clic su Invia per la revisione. Alcune sezioni potrebbero richiedere di fornire una motivazione aggiuntiva prima di poter inviare la richiesta. Fornisci la giustificazione e fai clic su Procedi all'invio delle modifiche.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere l'eliminazione di una voce, utilizza il metodo entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui esiste il gruppo di voci, ad esempio us-central1.
  • ENTRY_GROUP_ID: l'ID del gruppo di voci padre.
  • ENTRY_ID: l'ID della voce di destinazione che vuoi eliminare.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Aggiorna un aspetto

Console

Per richiedere aggiornamenti a un aspetto:

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

Vai alla Ricerca

  1. Cerca e seleziona la voce per cui vuoi richiedere la modifica.
  2. Fai clic sulla voce per aprire la pagina Dettagli voce.
  3. Vai alla sezione Aspetti e fai clic su Aggiungi.
  4. Fornisci i dettagli dell'aspetto.
  5. (Facoltativo) Fornisci la motivazione della modifica.
  6. Fai clic su Invia per la revisione.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere il collegamento o l'aggiornamento di un aspetto Contatti in una voce, utilizza il metodo entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "updateEntryRequest": {
      "entry": {
        "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
        "aspects": {
          "dataplex-types.global.contacts": {
            "data": {
              "identities": [
                {
                  "role": "Data Steward",
                  "name": "Dana",
                  "id": "dana@example.com"
                }
              ]
            }
          }
        }
      },
      "updateMask": {
        "paths": [
          "aspects"
        ]
      },
      "aspectKeys": [
        "dataplex-types.global.contacts"
      ]
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui esiste il gruppo di voci, ad esempio us-central1.
  • ENTRY_GROUP_ID: l'ID del gruppo di voci padre.
  • ENTRY_ID: l'ID della voce di destinazione.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Crea un link di ingresso

Console

Segui questi passaggi per richiedere la creazione di un link di voce, ad esempio per allegare un termine del glossario:

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

    Vai alla Ricerca

  2. Cerca e seleziona la voce dell'asset di dati a cui vuoi collegare un termine.

  3. Nella pagina dei dettagli della voce, esegui una delle seguenti operazioni:

    • Per collegare un termine alla voce, nella scheda Dettagli, nella sezione Termini del glossario, fai clic su Aggiungi.
    • Per collegare un termine a una colonna, nella scheda Schema, seleziona la colonna e fai clic su Aggiungi termine aziendale.

  4. Cerca e seleziona il termine da collegare.

  5. (Facoltativo) Fornisci una giustificazione per la modifica.

  6. Fai clic su Invia per la revisione.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere la creazione di un link di definizione tra un termine del glossario e una voce di un asset di dati, utilizza il metodo entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "createEntryLinkRequest": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
      "entryLinkId": "sample-definition-link",
      "entryLink": {
        "entryLinkType": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
        "entryReferences": [
          {
            "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
            "type": "SOURCE"
          },
          {
            "name": "projects/PROJECT_ID/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_ID/locations/global/glossaries/GLOSSARY_ID/terms/TERM_ID",
            "type": "TARGET"
          }
        ]
      }
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui esiste il gruppo di voci, ad esempio us-central1.
  • ENTRY_GROUP_ID: l'ID del gruppo di voci padre.
  • ENTRY_ID: l'ID della voce di destinazione.
  • GLOSSARY_ID: l'ID del glossario contenente il termine.
  • TERM_ID: l'ID del termine del glossario.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Elimina un collegamento di voce

Console

Per richiedere l'eliminazione di un link di voce, ad esempio per rimuovere un termine del glossario allegato, segui questi passaggi:

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

    Vai alla Ricerca

  2. Cerca e seleziona la voce dell'asset di dati da cui vuoi rimuovere un termine collegato.

  3. Nella pagina dei dettagli della voce, esegui una delle seguenti operazioni:

    • Per rimuovere un termine dalla voce, nella scheda Dettagli, nella sezione Termini del glossario, fai clic sul termine, quindi su Rimuovi.
    • Per rimuovere un termine da una colonna, nella scheda Schema, fai clic su Rimuovi accanto al termine.

  4. (Facoltativo) Fornisci una giustificazione per la modifica.

  5. Fai clic su Invia per la revisione.

Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore. Puoi monitorare l'avanzamento della richiesta nella pagina Workflow di governance nella scheda Le mie richieste.

REST

Per richiedere l'eliminazione di un link di voce tra un termine del glossario e una voce di asset di dati, utilizza il metodo entryGroups.requestCatalogChange:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID",
    "deleteEntryLinkRequest": {
      "name": "projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID"
    },
    "justification": "JUSTIFICATION"
  }' \
  "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/entryGroups/ENTRY_GROUP_ID:requestCatalogChange"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • LOCATION: la regione in cui esiste il gruppo di voci, ad esempio us-central1.
  • ENTRY_GROUP_ID: l'ID del gruppo di voci padre.
  • ENTRY_LINK_ID: l'ID del link della voce di destinazione che vuoi eliminare.
  • JUSTIFICATION: una spiegazione del motivo per cui proponi la modifica.

Il servizio restituisce una risposta contenente il nome della risorsa della richiesta di modifica. Il sistema registra una nuova richiesta di modifica e invia una notifica all'approvatore.

Passaggi successivi