In Knowledge Catalog nach Ressourcen suchen

Mit der Knowledge Catalog-Suche (früher Dataplex Universal Catalog) können Sie Ressourcen in Ihrer Organisation finden. Dabei werden die Suche in natürlicher Sprache mit semantischem Abgleich, die Stichwortsuche und eine umfangreiche Suchsyntax unterstützt.

Anwendungsfälle

In der folgenden Liste werden häufige Anwendungsfälle für die Suche beschrieben. Außerdem finden Sie Beschreibungen und Beispielabfragen:

  • Gezielte Suche nach Assets: Sie können nach einem bestimmten Asset suchen, indem Sie Keywords eingeben, die sich auf den Asset-Namen, die Spalten oder die Beschreibung beziehen.

    Beispielabfragen

    • retail_transactions_2026
    • customer_id
    • column:customer_id

  • Umfassende Datenerkennung: Identifizieren Sie relevante Assets in Ihrer Organisation mithilfe von offenen Anfragen in natürlicher Sprache oder Keyword-Anfragen.

    Beispielabfragen

    • quarterly financial reports
    • ad campaign click through rates tables
    • server health metrics
    • audit logs system=bigquery

  • Abrufen von Assets mit Bereich für Workflows: Assets in einem bestimmten Container, z. B. einem Projekt, oder mit bestimmten Eigenschaften, z. B. Typ oder System, auflisten. Diese Methode wird häufig für programmatische und agentenbasierte Workflows verwendet.

    Beispielabfragen

    • type=table projectid:banking-prod aspect:classification.tier=PII
    • system=spanner projectid:inventory-service (parent=marketing_analytics OR parent=finance_analytics)

Sie haben folgende Möglichkeiten, auf die Suche in Knowledge Catalog zuzugreifen:

Funktionsweise

Search indexiert automatisch den gesamten Kontext für Daten-Assets, die in Knowledge Catalog verwaltet werden. Der Support umfasst

  • Metadaten, die automatisch aus Google Cloud Datenquellen wie BigQuery und Cloud SQL aufgenommen werden
  • Kontext für Ressourcen, die Sie über Connectors und Integrationen aufnehmen
  • Zusätzlicher Kontext, den Sie für Ressourcen erstellen (z. B. zur Darstellung des geschäftlichen Kontexts oder zur Beschreibung der Datensemantik) und der in Form von Aspekten oder verknüpften Geschäftsbedingungen erfasst wird.

Bei der Verarbeitung Ihrer Anfrage wendet die Suche eine Kombination aus semantischem und Keyword-Abgleich an. In der folgenden Tabelle werden die Abfragetypen beschrieben, die Sie für die Knowledge Catalog-Suche verwenden können. Außerdem finden Sie Beschreibungen und Beispielabfragen:

Abfragetyp Nutzung Beispiele
Einzelnes Keyword Für genaue und Teilstring-Abgleiche von Metadatenelementen wie Asset-Name, Beschreibung und Schema. prd_fin_invoices_fct_v02
Teilweise Keywords und tokenisierte Fragmente Es werden Teilstrings in Metadateninhalten abgeglichen. So werden Ressourcen auch bei abgekürzten Begriffen, getrennten Wörtern oder Namensvariationen gefunden. fin transactions 2026 (entspricht prd_fin_transactions_fy2026_raw)
Abfragen in natürlicher Sprache Verwendet den semantischen Abgleich, ohne dass genaue Namens- oder Spaltenübereinstimmungen erforderlich sind. customer churn prediction features
Strukturierte Prädikate Kombiniert Freitextanfragen mit expliziten Prädikatfiltern, um Suchergebnisse einzugrenzen. audit logs system=bigquery
Erweiterte Syntax Für eine präzise Suche, die auf einen bestimmten Bereich eingegrenzt ist. Die erweiterte Syntax wird am häufigsten in agentischen und programmatischen Anwendungsfällen verwendet. Weitere Informationen finden Sie unter Suchsyntax. (system:bigquery OR system:spanner) AND column:credit_card_number aspect:classification.tier=PII -projectid:sandbox-project

Suchbereich

Bei den Suchergebnissen in Knowledge Catalog werden die Berechtigungen berücksichtigt, die Sie für die entsprechenden Ressourcen in Quellsystemen haben.

Wenn Sie beispielsweise BigQuery-Metadaten-Lesezugriff auf ein Objekt haben, wird dieses Objekt in Ihren Knowledge Catalog-Suchergebnissen angezeigt. Wenn Sie Zugriff auf eine BigQuery-Tabelle, aber nicht auf das Dataset haben, das diese Tabelle enthält, wird die Tabelle trotzdem in der Knowledge Catalog-Suche wie erwartet angezeigt.

Standardmäßig ist die Suche auf Ihre Organisation beschränkt. Die Ergebnisse enthalten nur Ressourcen aus derselben Organisation wie das Projekt, in dem Sie suchen.

Die Suchergebnisse enthalten nur Ressourcen, die zum selben VPC Service Controls-Perimeter wie das Projekt gehören, unter dem die Suche ausgeführt wird. Wenn Sie dieGoogle Cloud -Konsole verwenden, ist dies das Projekt, das in der Konsole ausgewählt ist.

Wenn Sie den Umfang Ihrer Suchergebnisse über die Ressourcen innerhalb des VPC Service Controls-Perimeters Ihres Projekts hinaus erweitern möchten, verwenden Sie VPC Service Controls-Regeln für ein- und ausgehenden Traffic. Diese Regeln erleichtern den privaten und effizienten Datenaustausch in Ihrer Organisation. Sie können Regeln für eingehenden und ausgehenden Traffic über dieGoogle Cloud Console oder über JSON- oder YAML-Dateien konfigurieren. Sehen Sie sich das folgende YAML-Beispiel an und lesen Sie die Dokumentation zu VPC Service Controls, um die Regel an Ihre spezifischen Anforderungen anzupassen.

egressPolicies:
  - egressFrom:
      identityType: ANY_USER_ACCOUNT
    egressTo:
      # Specify which resources should be present in the search results. In this example,
      # BigQuery.
      operations:
      - methodSelectors:
        - method: '*'
        serviceName: bigquery.googleapis.com
      # Specify project ids under which the search is performed.
      resources:
      - projects/SEARCH_PROJECT_ID
ingressPolicies:
  - ingressFrom:
      identityType: ANY_USER_ACCOUNT
      sources:
      - accessLevel: '*'
    ingressTo:
      # Specify which resources should be present in the search results. In this example,
      # BigQuery.
      operations:
      - methodSelectors:
        - method: '*'
        serviceName: bigquery.googleapis.com
      # Specify project ids to expose in search results.
      resources:
      - projects/INGRESS_PROJECT_ID

Weitere Informationen zu den IAM-Rollen (Identity and Access Management), die Sie für die Knowledge Catalog-Suche benötigen, finden Sie unter Knowledge Catalog-IAM-Rollen.

Suchergebnisse mithilfe von VPC Service Controls nach Umgebung isolieren

Wenn Sie die Suchergebnisse des Knowledge Catalog zwischen Umgebungen wie Entwicklung, Test und Produktion isolieren möchten, konfigurieren Sie separate VPC Service Controls-Perimeter für jede Umgebung. Weisen Sie sowohl die Projekte, die die Daten-Assets enthalten, als auch die Projekte, die für die Durchführung von Suchvorgängen verwendet werden, dem Perimeter der entsprechenden Umgebung zu. Bei Suchanfragen, die über ein Projekt innerhalb eines bestimmten Perimeters ausgeführt werden, werden nur Ergebnisse für Assets zurückgegeben, die sich ebenfalls in diesem Perimeter befinden.

Einschränkungen bei der Erinnerungsfunktion in der Suche

Knowledge Catalog-Suchanfragen garantieren keine vollständige Trefferquote. Das bedeutet, dass die Suche möglicherweise keine Ergebnisse zurückgibt, die Ihrer Anfrage entsprechen. Außerdem können die zurückgegebenen (und nicht zurückgegebenen) Ergebnisse variieren, wenn Sie Suchanfragen wiederholen.

Wenn Sie alle Knowledge Catalog-Metadaten abfragen möchten, können Sie die Metadaten in Cloud Storage exportieren und dann in BigQuery abfragen. Weitere Informationen finden Sie unter Metadaten exportieren.

Hinweis

Bevor Sie eine Suche durchführen, müssen Sie sicherstellen, dass Ihnen die erforderlichen Rollen zugewiesen wurden und Sie die erforderliche API aktiviert haben.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Suchen nach Einträgen und zum Aufrufen von Suchergebnissen im Knowledge Catalog 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.

Berechtigungen für Suchergebnisse werden unabhängig vom ausgewählten Projekt geprüft.

Die Suchergebnisse in Knowledge Catalog werden entsprechend Ihrer Rolle gefiltert. Wenn Sie in Knowledge Catalog nach einem Asset suchen möchten, benötigen Sie Berechtigungen für den Zugriff auf die entsprechende Ressource im Quellsystem. Weitere Informationen finden Sie im Abschnitt Suchbereich in diesem Dokument.

Wenn Sie beispielsweise nach BigQuery-Datasets, -Tabellen, -Ansichten und -Modellen suchen möchten, benötigen Sie die entsprechenden Berechtigungen für diese Einträge. Weitere Informationen finden Sie unter BigQuery-Berechtigungen.

In der folgenden Liste werden die erforderlichen Mindestberechtigungen beschrieben:

  • Zum Suchen nach einer Tabelle benötigen Sie die Berechtigung bigquery.tables.get für diese Tabelle.
  • Zur Suche nach einem Dataset benötigen Sie die Berechtigung bigquery.datasets.get für dieses Dataset.

Wenn Sie beispielsweise nach Cloud SQL-Instanzen, Datenbanken, Schemas, Tabellen und Ansichten suchen möchten, benötigen Sie die entsprechenden Berechtigungen für diese Einträge. Weitere Informationen finden Sie unter Cloud SQL-Rollen und -Berechtigungen.

API aktivieren

Dataplex API aktivieren

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 Rolle „Inhaber“ (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

Nach Ressourcen suchen

Console

So suchen Sie nach Ressourcen:

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

    Zur Suche

  2. Wenn Sie die Aufforderung Suche in natürlicher Sprache ausprobieren sehen, klicken Sie darauf. Standardmäßig ist die Suche in natürlicher Sprache ausgewählt.

  3. Geben Sie im Feld Mit der Suche in natürlicher Sprache projektübergreifend nach Ressourcen suchen Ihre Anfrage ein und klicken Sie dann auf die Eingabetaste.

  4. Klicken Sie auf Filter, um die Suche einzugrenzen. Eine Liste der verfügbaren Filter finden Sie unter Filter.

  5. Wenn Sie weitere Informationen zur gesuchten Ressource aufrufen möchten, klicken Sie in den Suchergebnissen auf den Ressourcennamen. Dadurch wird die Seite mit den Eintragsdetails geöffnet.

Google Cloud CLI

Verwenden Sie den Befehl gcloud dataplex entries search, um nach Ressourcen zu suchen:

gcloud dataplex entries search 'foo' \
  --project=PROJECT_ID \
  [--semantic-search]

Ersetzen Sie PROJECT_ID durch die ID des Google Cloud -Projekts.

C#

C#

Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog C# API.

Richten Sie zur Authentifizierung bei Knowledge Catalog die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten. 

using Google.Api.Gax;
using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using System;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for SearchEntries</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void SearchEntriesRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        SearchEntriesRequest request = new SearchEntriesRequest
        {
            LocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            Query = "",
            OrderBy = "",
            Scope = "",
            SemanticSearch = false,
        };
        // Make the request
        PagedEnumerable<SearchEntriesResponse, SearchEntriesResult> response = catalogServiceClient.SearchEntries(request);

        // Iterate over all response items, lazily performing RPCs as required
        foreach (SearchEntriesResult item in response)
        {
            // Do something with each item
            Console.WriteLine(item);
        }

        // Or iterate over pages (of server-defined size), performing one RPC per page
        foreach (SearchEntriesResponse page in response.AsRawResponses())
        {
            // Do something with each page of items
            Console.WriteLine(