Metadatenänderungen mit Governance-Workflows anfordern

In diesem Dokument wird beschrieben, wie Sie mithilfe von Governance-Workflows Änderungen an einzelnen Ressourcen für Kategorien und Begriffe im Unternehmensglossar sowie für Einträge im Knowledge Catalog (ehemals Dataplex Universal Catalog) vorschlagen.

Hinweis

Wenn Sie Governance-Workflows für Metadatenänderungen verwenden möchten, müssen Sie die erforderlichen APIs aktivieren und die erforderlichen IAM-Rollen (Identity and Access Management) und ‑Berechtigungen haben.

Aktivieren Sie die Dataplex API, falls sie noch nicht aktiviert ist.

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

API aktivieren

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt, Ihr Glossar oder Ihre Eintraggruppe zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Anfordern von Metadatenänderungen benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Weitere Informationen zu Rollen und Berechtigungen finden Sie unter IAM-Rollen für Knowledge Catalog.

Änderungen für eine Glossarkategorie anfordern

Wenn Sie keinen direkten Schreibzugriff zum Erstellen, Aktualisieren oder Löschen einer Glossarkategorie haben, können Sie eine solche Änderung über Governance-Workflows anfordern. Nachdem eine Anfrage zur Metadatenänderung eingereicht wurde, können Antragsteller, Genehmiger und Workflow-Administratoren die Anfrage während ihres gesamten Lebenszyklus beobachten und verwalten.

Kategorie erstellen

Console

So beantragen Sie eine Kategorie:

  1. Rufen Sie in der Google Cloud Console die Seite Glossare im Knowledge Catalog auf.

    Zu Glossaren

  2. Wählen Sie das Glossar aus, in dem Sie eine Kategorie erstellen möchten, und klicken Sie dann auf Kategorie erstellen.

  3. Geben Sie einen Anzeigenamen für die Kategorie ein.

  4. Optional: Fügen Sie im Abschnitt Labels Labels für das Glossar hinzu.

  5. Optional: Geben Sie im Abschnitt Begründung dem Genehmiger einen Grund für Ihre Änderung an.

  6. Im Abschnitt Erweiterte Einstellungen können Sie die Kategorie-ID bearbeiten, wenn Sie die automatisch generierte ID ändern möchten.

  7. Klicken Sie auf Zur Überprüfung einreichen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Verwenden Sie die Methode glossaries.requestGlossaryChange, um das Erstellen einer Kategorie anzufordern:

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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: Die Region, in der sich das Glossar befindet, z. B. us-central1.
  • GLOSSARY_ID: die ID des übergeordneten Glossars.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Kategorie ändern

Console

So schlagen Sie Änderungen an einer Kategorie vor:

  1. Rufen Sie in der Google Cloud Console die Seite Glossare im Knowledge Catalog auf.

    Zu Glossaren

  2. Wählen Sie das Glossar aus, das die Kategorie enthält, die Sie aktualisieren möchten.

  3. Klicken Sie auf den Kategorienamen, um den Bereich Kategoriedetails zu öffnen.

  4. Wenn Sie Kategoriedetails hinzufügen oder aktualisieren möchten, klicken Sie neben dem Abschnitt, den Sie aktualisieren möchten, auf Hinzufügen oder Bearbeiten.

  5. Klicken Sie auf Zur Überprüfung einreichen. Für einige Elemente ist möglicherweise eine zusätzliche Begründung für die Änderung erforderlich. Geben Sie die Begründung an und klicken Sie auf Weiter zum Einreichen von Änderungen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Verwenden Sie die Methode glossaries.requestGlossaryChange, um eine Aktualisierung des Anzeigenamens und der Beschreibung einer Kategorie anzufordern:

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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: Die Region, in der sich das Glossar befindet, z. B. us-central1.
  • GLOSSARY_ID: die ID des übergeordneten Glossars.
  • CATEGORY_ID: die ID der Zielkategorie, die Sie aktualisieren möchten.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Kategorie löschen

Console

So beantragen Sie das Löschen einer Kategorie:

  1. Rufen Sie in der Google Cloud Console die Seite Glossare im Knowledge Catalog auf.

    Zu Glossaren

  2. Maximieren Sie das Glossar und klicken Sie auf die Kategorie, die Sie löschen möchten.

  3. Wählen Sie im Bereich Kategoriedetails im Menü die Option Löschen aus.

  4. Optional: Geben Sie im Abschnitt Begründung den Grund für Ihre Änderung an.

  5. Klicken Sie auf Zur Überprüfung einreichen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Verwenden Sie die Methode glossaries.requestGlossaryChange, um das Löschen einer Kategorie anzufordern:

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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: Die Region, in der sich das Glossar befindet, z. B. us-central1.
  • GLOSSARY_ID: die ID des übergeordneten Glossars.
  • CATEGORY_ID: die ID der Zielkategorie, die Sie löschen möchten.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Änderungen für einen Glossarbegriff anfordern

Wenn Sie keinen direkten Schreibzugriff zum Erstellen, Aktualisieren oder Löschen eines Glossarbegriffs haben, können Sie eine solche Änderung über Governance-Workflows anfordern.

Glossarbegriff erstellen

Console

So beantragen Sie die Erstellung eines Glossarbegriffs:

  1. Rufen Sie in der Google Cloud Console die Seite Glossare im Knowledge Catalog auf.

    Zu Glossaren

  2. Wählen Sie das Glossar oder die Kategorie aus, in der Sie einen Begriff erstellen möchten, um den Detailbereich zu öffnen.

    • Wenn Sie einen Begriff auf der Detailseite des Glossars erstellen, wählen Sie im Menü Begriff erstellen aus.
    • Wenn Sie einen Begriff auf der Seite mit den Kategoriedetails erstellen, wählen Sie im Menü Begriff hinzufügen aus.

  3. Geben Sie einen Anzeigenamen für die Kategorie ein.

  4. Optional: Fügen Sie im Bereich Labels Labels für den Begriff hinzu.

  5. Optional: Geben Sie im Abschnitt Begründung dem Genehmiger einen Grund für Ihre Änderung an.

  6. Im Abschnitt Erweiterte Einstellungen können Sie die Begriffs-ID bearbeiten, wenn Sie die automatisch generierte ID ändern möchten.

  7. Klicken Sie auf Zur Überprüfung einreichen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Verwenden Sie die Methode glossaries.requestGlossaryChange, um die Erstellung eines Glossarbegriffs anzufordern:

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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: Die Region, in der sich das Glossar befindet, z. B. us-central1.
  • GLOSSARY_ID: die ID des übergeordneten Glossars.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Glossarbegriff aktualisieren

Console

So beantragen Sie Änderungen an einem Glossarbegriff:

  1. Rufen Sie in der Google Cloud Console die Seite Glossare im Knowledge Catalog auf.

    Zu Glossaren

  2. Wählen Sie das Glossar aus, das den Begriff enthält, den Sie aktualisieren möchten.

  3. Klicken Sie auf den Namen des Begriffs, um den Bereich Begriffsdetails zu öffnen.

  4. Fügen Sie Details zu den Bedingungen hinzu oder aktualisieren Sie sie, indem Sie neben dem Bereich, den Sie aktualisieren möchten, auf Hinzufügen oder Bearbeiten klicken.

  5. Klicken Sie auf Zur Überprüfung einreichen. In einigen Abschnitten müssen Sie möglicherweise eine zusätzliche Begründung angeben, bevor Sie die Anfrage senden können. Geben Sie die Begründung an und klicken Sie auf Weiter zum Einreichen von Änderungen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Wenn Sie eine Aktualisierung des Anzeigenamens und der Beschreibung eines Glossarbegriffs anfordern möchten, verwenden Sie die Methode 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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: Die Region, in der sich das Glossar befindet, z. B. us-central1.
  • GLOSSARY_ID: die ID des übergeordneten Glossars.
  • TERM_ID: die ID des Zielbegriffs, den Sie aktualisieren möchten.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Glossarbegriff löschen

Console

So beantragen Sie das Löschen eines Begriffs:

  1. Rufen Sie in der Google Cloud Console die Seite Glossare im Knowledge Catalog auf.

    Zu Glossaren

  2. Wählen Sie das Glossar aus, das den Begriff enthält, den Sie löschen möchten.

  3. Klicken Sie auf den Namen des Begriffs, um den Bereich Begriffsdetails zu öffnen.

  4. Klicken Sie auf Löschen.

  5. Klicken Sie auf Zur Überprüfung einreichen. In einigen Abschnitten müssen Sie möglicherweise eine zusätzliche Begründung angeben, bevor Sie die Anfrage senden können. Geben Sie die Begründung an und klicken Sie auf Weiter zum Einreichen von Änderungen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Verwenden Sie die Methode glossaries.requestGlossaryChange, um das Löschen eines Glossarbegriffs anzufordern:

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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: Die Region, in der sich das Glossar befindet, z. B. us-central1.
  • GLOSSARY_ID: die ID des übergeordneten Glossars.
  • TERM_ID: die ID des Zielbegriffs, den Sie löschen möchten.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt einen RequestGlossaryChangeResponse zurück, der den Ressourcennamen der ChangeRequest enthält. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Änderungen für einen Eintrag anfordern

Wenn Sie keinen direkten Schreibzugriff zum Erstellen, Ändern oder Löschen eines Knowledge Catalog-Eintrags haben, können Sie eine solche Änderung über Governance-Workflows anfordern.

Eintrag erstellen

Console

So beantragen Sie die Erstellung eines Eintrags:

  1. Rufen Sie in der Google Cloud Console die Seite Metadatentypen des Knowledge Catalog auf.

    Zu „Metadatentypen“

  2. Klicken Sie auf den Tab Eintragsgruppen.

  3. Wählen Sie die Eintraggruppe aus, in der Sie einen Eintrag erstellen möchten, und klicken Sie dann auf Eintrag erstellen.

  4. Geben Sie eine ID und einen Anzeigenamen für den Eintrag ein.

  5. Wählen Sie einen Eintragstyp aus.

  6. Optional: Geben Sie Details zum Aspekt an oder fügen Sie eine Beschreibung hinzu.

  7. Klicken Sie auf Zur Überprüfung einreichen. In einigen Abschnitten müssen Sie möglicherweise eine zusätzliche Begründung angeben, bevor Sie die Anfrage senden können. Geben Sie die Begründung an und klicken Sie auf Weiter zum Einreichen von Änderungen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Verwenden Sie die Methode entryGroups.requestCatalogChange, um das Erstellen eines Eintrags anzufordern:

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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: die Region, in der die Eintraggruppe vorhanden ist, z. B. us-central1.
  • ENTRY_GROUP_ID: die ID der übergeordneten Eintraggruppe.
  • ENTRY_TYPE_ID: die ID des Eintragstyps.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Eintrag aktualisieren

Console

So fordern Sie Aktualisierungen für einen Eintrag an:

  1. Rufen Sie in der Google Cloud Console die Seite Suchen oder Katalog im Knowledge Catalog auf.

Zur Suche

  1. Suchen Sie nach dem Eintrag, den Sie aktualisieren möchten, und wählen Sie ihn aus.
  2. Klicken Sie auf den Eintrag, um die Seite Eintragsdetails zu öffnen.
  3. Klicken Sie neben dem Bereich, den Sie aktualisieren möchten, auf Hinzufügen.
  4. Aktualisieren Sie den Abschnitt.
  5. Klicken Sie auf Zur Überprüfung einreichen. In einigen Abschnitten müssen Sie möglicherweise eine zusätzliche Begründung angeben, bevor Sie die Anfrage senden können. Geben Sie die Begründung an und klicken Sie auf Weiter zum Einreichen von Änderungen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Wenn Sie eine Aktualisierung des Anzeigenamens und der Beschreibung einer Eintragsquelle anfordern möchten, verwenden Sie die Methode 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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: die Region, in der die Eintraggruppe vorhanden ist, z. B. us-central1.
  • ENTRY_GROUP_ID: die ID der übergeordneten Eintraggruppe.
  • ENTRY_ID: die ID des Zieleintrags.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Eintrag löschen

Console

So beantragen Sie das Löschen eines Eintrags:

  1. Rufen Sie in der Google Cloud Console die Seite Suchen oder Katalog im Knowledge Catalog auf.

Zur Suche

  1. Suchen Sie nach dem Eintrag, den Sie löschen möchten, und wählen Sie ihn aus.
  2. Klicken Sie auf den Eintrag, um die Seite Eintragsdetails zu öffnen.
  3. Klicken Sie auf Löschen.
  4. Klicken Sie auf Zur Überprüfung einreichen. In einigen Abschnitten müssen Sie möglicherweise eine zusätzliche Begründung angeben, bevor Sie die Anfrage senden können. Geben Sie die Begründung an und klicken Sie auf Weiter zum Einreichen von Änderungen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Verwenden Sie die Methode entryGroups.requestCatalogChange, um das Löschen eines Eintrags anzufordern:

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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: die Region, in der die Eintraggruppe vorhanden ist, z. B. us-central1.
  • ENTRY_GROUP_ID: die ID der übergeordneten Eintraggruppe.
  • ENTRY_ID: die ID des Zieleintrags, den Sie löschen möchten.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Aspekt aktualisieren

Console

So fordern Sie Aktualisierungen für einen Aspekt an:

  1. Rufen Sie in der Google Cloud Console die Seite Suchen im Knowledge Catalog auf.

Zur Suche

  1. Suchen Sie nach dem Eintrag, für den Sie die Änderung beantragen möchten, und wählen Sie ihn aus.
  2. Klicken Sie auf den Eintrag, um die Seite Eintragsdetails zu öffnen.
  3. Wechseln Sie zum Abschnitt Aspekte und klicken Sie auf Hinzufügen.
  4. Geben Sie Aspektdetails an.
  5. Optional: Geben Sie eine Begründung für die Änderung an.
  6. Klicken Sie auf Zur Überprüfung einreichen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Wenn Sie einen Kontaktaspekt an einen Eintrag anhängen oder aktualisieren möchten, verwenden Sie die Methode 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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: die Region, in der die Eintraggruppe vorhanden ist, z. B. us-central1.
  • ENTRY_GROUP_ID: die ID der übergeordneten Eintraggruppe.
  • ENTRY_ID: die ID des Zieleintrags.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Eintragslink erstellen

Console

So fordern Sie die Erstellung eines Eintragslinks an, z. B. um einen Glossarbegriff anzuhängen:

  1. Rufen Sie in der Google Cloud Console die Seite Suchen im Knowledge Catalog auf.

    Zur Suche

  2. Suchen Sie nach dem Daten-Asset-Eintrag, mit dem Sie einen Begriff verknüpfen möchten, und wählen Sie ihn aus.

  3. Führen Sie auf der Seite mit den Eintragsdetails einen der folgenden Schritte aus:

    • Wenn Sie einen Begriff mit dem Eintrag verknüpfen möchten, klicken Sie auf dem Tab Details im Abschnitt Glossarbegriffe auf Hinzufügen.
    • Wenn Sie einen Begriff mit einer Spalte verknüpfen möchten, wählen Sie auf dem Tab Schema die Spalte aus und klicken Sie auf Geschäftlichen Begriff hinzufügen.

  4. Suchen Sie nach dem Begriff, den Sie verknüpfen möchten, und wählen Sie ihn aus.

  5. Optional: Geben Sie eine Begründung für die Änderung an.

  6. Klicken Sie auf Zur Überprüfung einreichen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Wenn Sie einen Definitionslink zwischen einem Glossarbegriff und einem Daten-Asset-Eintrag erstellen möchten, verwenden Sie die Methode 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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: die Region, in der die Eintraggruppe vorhanden ist, z. B. us-central1.
  • ENTRY_GROUP_ID: die ID der übergeordneten Eintraggruppe.
  • ENTRY_ID: die ID des Zieleintrags.
  • GLOSSARY_ID: die ID des Glossars, das den Begriff enthält.
  • TERM_ID: die ID des Glossarbegriffs.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Eintragslink löschen

Console

So fordern Sie das Löschen eines Eintragslinks an, z. B. um einen angehängten Glossarbegriff zu entfernen:

  1. Rufen Sie in der Google Cloud Console die Seite Suchen im Knowledge Catalog auf.

    Zur Suche

  2. Suchen Sie nach dem Daten-Asset-Eintrag, aus dem Sie einen verknüpften Begriff entfernen möchten, und wählen Sie ihn aus.

  3. Führen Sie auf der Seite mit den Eintragsdetails einen der folgenden Schritte aus:

    • Wenn Sie einen Begriff aus dem Eintrag entfernen möchten, klicken Sie auf dem Tab Details im Abschnitt Glossarbegriffe auf den Begriff und dann auf Entfernen.
    • Wenn Sie einen Begriff aus einer Spalte entfernen möchten, klicken Sie auf dem Tab Schema neben dem Begriff auf Entfernen.

  4. Optional: Geben Sie eine Begründung für die Änderung an.

  5. Klicken Sie auf Zur Überprüfung einreichen.

Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger. Sie können den Fortschritt der Anfrage auf der Seite Governance-Workflows auf dem Tab Meine Anfragen verfolgen.

REST

Wenn Sie das Löschen einer Eintragsverknüpfung zwischen einem Glossarbegriff und einem Daten-Asset-Eintrag anfordern möchten, verwenden Sie die Methode 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"

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID IhresGoogle Cloud -Projekts.
  • LOCATION: die Region, in der die Eintraggruppe vorhanden ist, z. B. us-central1.
  • ENTRY_GROUP_ID: die ID der übergeordneten Eintraggruppe.
  • ENTRY_LINK_ID: die ID des Links zum Zieleintrag, den Sie löschen möchten.
  • JUSTIFICATION: eine Erklärung, warum Sie die Änderung vorschlagen.

Der Dienst gibt eine Antwort mit dem Ressourcennamen der Änderungsanfrage zurück. Das System protokolliert eine neue Änderungsanfrage und benachrichtigt den Genehmiger.

Nächste Schritte