Nur nach Keywords in Knowledge Catalog suchen

Hinweis :Wenn Sie Knowledge Catalog-Daten abfragen möchten, verwenden Sie die Knowledge Catalog-Suche. Verwenden Sie die reine Keyword-Suche nur zur Abwärtskompatibilität.

Mit der Keyword-Suche im Knowledge Catalog können Sie Ressourcen anhand bestimmter Keywords, Filter und einer definierten Syntax finden. Die Suche nur nach Keywords bietet Ihnen eine präzise Kontrolle über Ihre Suchanfragen und ermöglicht es Ihnen, die Ergebnisse anhand von Metadatenfeldern einzugrenzen.

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:

• Nach Einträgen suchen:
  • Dataplex Catalog Admin (roles/dataplex.catalogAdmin) für das Projekt, das für die Suche verwendet wird
  • Dataplex Catalog Editor (roles/dataplex.catalogEditor) für das Projekt, das für die Suche verwendet wird
  • Dataplex Catalog-Betrachter (roles/dataplex.catalogViewer) für das Projekt, das für die Suche verwendet wird
• Metadaten für BigQuery-Datasets und -Tabellen suchen: BigQuery-Metadatenbetrachter (roles/bigquery.metadataViewer) für das Dataset oder die Tabelle
• Nach benutzerdefinierten Einträgen suchen: Dataplex Catalog Viewer (roles/dataplex.catalogViewer) für das Projekt

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.

Nur Keyword-Suche verwenden

Console

So suchen Sie mit der Keyword-Suche nach Ressourcen:

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

   Zur Suche

2. Wenn Ihre Suchplattform auf Data Catalog festgelegt ist, wählen Sie im Menü Suchplattform auswählen die Option Knowledge Catalog aus.

3. Geben Sie im Feld Ressourcen projektübergreifend suchen Ihre Anfrage ein.

4. Verwenden Sie zum Verfeinern der Suche den Bereich Filter. Folgende Filter sind verfügbar:

   • Unter Systeme finden Sie eine Liste der verfügbaren Systeme wie BigQuery oder Cloud SQL. Das Knowledge Catalog-System enthält benutzerdefinierte Einträge.
   • Mit Aspekten (Tags) können Sie nach Assets suchen, die mit einer bestimmten Vorlage getaggt wurden. Über das Menü Anpassen können Sie die Ergebnisse weiter eingrenzen und nach bestimmten Aspektwerten filtern.
   • Unter Projekt werden die Projekte aufgeführt, auf die Sie die Suche eingrenzen können.
   • Typaliasse sind Datentypen, die einem Eintragstyp zugeordnet sind. Ein Eintragstyp kann den Namen projects/test-project/locations/us/entryTypes/my-entry-type haben, Sie können aber auch mit den Typaliasen TABLE oder DATABASE danach suchen. Sie können einen oder mehrere Typaliase festlegen, wenn Sie einen Eintragstyp erstellen oder aktualisieren.
   • Datasets stammen aus BigQuery.

   Sie können die folgenden Filter manuell hinzufügen:

   • Projektfilter hinzufügen: Klicken Sie unter Projekt auf Projekt hinzufügen. Suchen Sie nach einem bestimmten Projekt, wählen Sie es aus und klicken Sie auf Öffnen.
   • Filter für Aspekttypen hinzufügen: Klicken Sie unter Aspekte auf das Menü Weitere Aspekttypen hinzufügen. Suchen Sie nach einer bestimmten Vorlage, wählen Sie sie aus und klicken Sie dann auf OK.

5. Optional: Zusätzlich zu den für Sie verfügbaren Assets können Sie nach Ressourcen suchen, die in Google Cloud öffentlich verfügbar sind. Wählen Sie dazu Öffentliche Datasets einschließen aus.

   Hier einige Tipps zum Erstellen einer Suchanfrage:

   • Setzen Sie den Suchausdruck in Anführungszeichen, wenn er Leerzeichen enthält. Beispiel: "search terms".
   • Stellen Sie einem Keyword NOT voran, um die logische Negation des Filters keyword:term zu berücksichtigen. Sie können auch die booleschen Operatoren AND und OR verwenden, um Suchausdrücke zu kombinieren. Bei den Operatoren AND, OR und NOT wird nicht zwischen Groß- und Kleinschreibung unterschieden.

   Beispiel: NOT column:term listet alle Spalten mit Ausnahme derjenigen auf, die dem angegebenen Begriff entsprechen.

6. 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.

gcloud

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

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("A page of results:");
            foreach (SearchEntriesResult item in page)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
        }

        // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
        int pageSize = 10;
        Page<SearchEntriesResult> singlePage = response.ReadPage(pageSize);
        // Do something with the page of items
        Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
        foreach (SearchEntriesResult item in singlePage)
        {
            // Do something with each item
            Console.WriteLine(item);
        }
        // Store the pageToken, for when the next page is required.
        string nextPageToken = singlePage.NextPageToken;
    }
}

Go

Go

Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog Go 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.

//go:build examples

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
	"google.golang.org/api/iterator"
)

func main() {
	ctx := context.Background()
	// 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://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.SearchEntriesRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#SearchEntriesRequest.
	}
	it := c.SearchEntries(ctx, req)
	for {
		resp, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			// TODO: Handle error.
		}
		// TODO: Use resp.
		_ = resp

		// If you need to access the underlying RPC response,
		// you can do so by casting the `Response` as below.
		// Otherwise, remove this line. Only populated after
		// first call to Next(). Not safe for concurrent access.
		_ = it.Response.(*dataplexpb.SearchEntriesResponse)
	}
}

Java

Java

Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog Java 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.

import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.LocationName;
import com.google.cloud.dataplex.v1.SearchEntriesRequest;
import com.google.cloud.dataplex.v1.SearchEntriesResult;

public class SyncSearchEntries {

  public static void main(String[] args) throws Exception {
    syncSearchEntries();
  }

  public static void syncSearchEntries() throws Exception {
    // 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/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      SearchEntriesRequest request =
          SearchEntriesRequest.newBuilder()
              .setName(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setQuery("query107944136")
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setOrderBy("orderBy-1207110587")
              .setScope("scope109264468")
              .setSemanticSearch(true)
              .build();
      for (SearchEntriesResult element : catalogServiceClient.searchEntries(request).iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

Node.js

Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog Node.js 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.

/**
 * 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.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The project to which the request should be attributed in the
 *  following form: `projects/{project}/locations/global`.
 */
// const name = 'abc123'
/**
 *  Required. The query against which entries in scope should be matched.
 *  The query syntax is defined in Search syntax for Dataplex Universal
 *  Catalog (https://cloud.google.com/dataplex/docs/search-syntax).
 */
// const query = 'abc123'
/**
 *  Optional. Number of results in the search page. If <=0, then defaults
 *  to 10. Max limit for page_size is 1000. Throws an invalid argument for
 *  page_size > 1000.
 */
// const pageSize = 1234
/**
 *  Optional. Page token received from a previous `SearchEntries` call. Provide
 *  this to retrieve the subsequent page.
 */
// const pageToken = 'abc123'
/**
 *  Optional. Specifies the ordering of results.
 *  Supported values are:
 *  * `relevance`
 *  * `last_modified_timestamp`
 *  * `last_modified_timestamp asc`
 */
// const orderBy = 'abc123'
/**
 *  Optional. The scope under which the search should be operating. It must
 *  either be `organizations/<org_id>` or `projects/<project_ref>`. If it is
 *  unspecified, it defaults to the organization where the project provided in
 *  `name` is located.
 */
// const scope = 'abc123'
/**
 *  Optional. Specifies whether the search should understand the meaning and
 *  intent behind the query, rather than just matching keywords.
 */
// const semanticSearch = true

// Imports the Dataplex library
const {CatalogServiceClient} = require('@google-cloud/dataplex').v1;

// Instantiates a client
const dataplexClient = new CatalogServiceClient();

async function callSearchEntries() {
  // Construct request
  const request = {
    name,
    query,
  };

  // Run request
  const iterable = dataplexClient.searchEntriesAsync(request);
  for await (const response of iterable) {
      console.log(response);
  }
}

callSearchEntries();

PHP

PHP

Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für PHP in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog PHP 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.

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Dataplex\V1\Client\CatalogServiceClient;
use Google\Cloud\Dataplex\V1\SearchEntriesRequest;
use Google\Cloud\Dataplex\V1\SearchEntriesResult;

/**
 * Searches for Entries matching the given query and scope.
 *
 * @param string $formattedName The project to which the request should be attributed in the
 *                              following form: `projects/{project}/locations/global`. Please see
 *                              {@see CatalogServiceClient::locationName()} for help formatting this field.
 * @param string $query         The query against which entries in scope should be matched.
 *                              The query syntax is defined in [Search syntax for Dataplex Universal
 *                              Catalog](https://cloud.google.com/dataplex/docs/search-syntax).
 */
function search_entries_sample(string $formattedName, string $query): void
{
    // Create a client.
    $catalogServiceClient = new CatalogServiceClient();

    // Prepare the request message.
    $request = (new SearchEntriesRequest())
        ->setName($formattedName)
        ->setQuery($query);

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $catalogServiceClient->searchEntries($request);

        /** @var SearchEntriesResult $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample 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,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = CatalogServiceClient::locationName('[PROJECT]', '[LOCATION]');
    $query = '[QUERY]';

    search_entries_sample($formattedName, $query);
}

Python

Python

Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog Python 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.

# 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://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_search_entries():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.SearchEntriesRequest(
        name="name_value",
        query="query_value",
    )

    # Make the request
    page_result = client.search_entries(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Ruby

Ruby

Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Knowledge Catalog Ruby 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.

require "google/cloud/dataplex/v1"

##
# Snippet for the search_entries call in the CatalogService service
#
# 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/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#search_entries.
#
def search_entries
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::SearchEntriesRequest.new

  # Call the search_entries method.
  result = client.search_entries request

  # The returned object is of type Gapic::PagedEnumerable. You can iterate
  # over elements, and API calls will be issued to fetch pages as needed.
  result.each do |item|
    # Each element is of type ::Google::Cloud::Dataplex::V1::SearchEntriesResult.
    p item
  end
end

REST

Verwenden Sie die Methode searchEntries, um nach Ressourcen zu suchen.

Suchsyntax nur für Keywords

Für genaue Suchanfragen können Sie eine Abfrage mit einer bestimmten Syntax erstellen, einschließlich Qualifizierern, logischen Operatoren und Aspektsuchen.

Qualifizierte Prädikate

Sie können ein Prädikat qualifizieren, indem Sie ihm einen Schlüssel voranstellen, der die Übereinstimmung auf ein bestimmtes Metadatenelement einschränkt:

• Ein Gleichheitszeichen (=) beschränkt die Suche auf eine genaue Übereinstimmung.
• Ein Doppelpunkt (:) nach dem Schlüssel vergleicht das Prädikat mit einem Teilstring oder einem Token innerhalb des Werts in den Suchergebnissen.

Bei der Tokenisierung wird der Textfluss in eine Reihe von Tokens unterteilt, wobei jedes Token in der Regel einem einzelnen Wort entspricht.

Die Prädikatschlüssel type, system, location und orgid unterstützen nur den Qualifikator für die genaue Übereinstimmung (=), nicht den Qualifikator für Teilstrings (:), z. B. type=foo oder orgid=number.

Die Keyword-Suche in Knowledge Catalog unterstützt die folgenden Qualifier:

Kennzeichner	Beschreibung
name:x	Führt zu Übereinstimmung von x mit einem Teilstring der Ressourcen-ID.
displayname:x	Führt zu Übereinstimmung von x mit einem Teilstring des Anzeigenamens der Ressource.
column:x	Führt zu Übereinstimmung von x mit einem Teilstring des Spaltennamens (oder des verschachtelten Spaltennamens) im Schema der Ressource.
description:x	Führt zu Übereinstimmung von x mit einem Token in der Ressourcenbeschreibung.
label:bar	Führt zu Übereinstimmung mit BigQuery-Ressourcen, die ein Label haben (mit einem Wert) und deren Labelschlüssel bar als Teilstring hat.
label=bar	Führt zu Übereinstimmung mit BigQuery-Ressourcen, die ein Label haben (mit einem Wert) und deren Labelschlüssel bar als String entspricht.
label:bar:x	Führt zu Übereinstimmung von x mit einem Teilstring im Wert eines Labels mit dem Schlüssel bar, das mit einer BigQuery-Ressource verknüpft ist.
label=foo:bar	Führt zu Übereinstimmung mit BigQuery-Ressourcen, bei denen der Schlüssel foo und der Schlüsselwert bar ist.
label.foo=bar	Führt zu Übereinstimmung mit BigQuery-Ressourcen, bei denen der Schlüssel gleich foo und der Schlüsselwert gleich bar ist.
label.foo	Führt zu Übereinstimmung mit BigQuery-Ressourcen, die ein Label haben, dessen Schlüssel als String foo entspricht.
type=TYPE	Führt zu Übereinstimmung mit Ressourcen eines bestimmten Eintrags oder seines Typalias.
projectid:bar	Führt zu Übereinstimmung mit Ressourcen in Google Cloud -Projekten, die bar als Teilstring in der ID enthalten.
parent:x	Führt zu Übereinstimmung von x mit einem Teilstring des hierarchischen Pfads einer Ressource. Der übergeordnete Pfad ist ein fully_qualified_name der übergeordneten Ressource.
orgid=number	Führt zu Übereinstimmung mit Ressourcen in einer Google Cloud Organisation mit dem genauen ID-Wert number.
system=SYSTEM	Führt zu Übereinstimmung mit Ressourcen aus einem angegebenen System.
location=LOCATION	Führt zu Übereinstimmung mit Ressourcen an einem angegebenen Standort mit einem genauen Namen. Beispiel: location=us-central1 stimmt mit Assets überein, die in Iowa gehostet werden. BigQuery Omni-Assets unterstützen diesen Qualifikator mit dem BigQuery Omni-Standortnamen. Beispiel: location=aws-us-east-1 entspricht BigQuery Omni-Assets in Northern Virginia.
createtime	Findet Ressourcen, die an bzw. zu, vor oder nach einem bestimmten Datum oder einer bestimmten Uhrzeit erstellt wurden. Beispiel: createtime:2019-01-01 führt zu Übereinstimmung mit Ressourcen, die am 01.01.2019 erstellt wurden. createtime<2019-02 stimmt mit Ressourcen überein, die vor dem 01.02.2019 um 00:00:00 Uhr erstellt wurden. createtime>2019-02 führt zu Übereinstimmung mit Ressourcen, die nach dem 01.02.2019 00:00:00 erstellt wurden. Zeitstempelformat: YYYY-MM-DDThh:mm:ss Alle Zeitstempel müssen in GMT angegeben sein. Zeitzonen werden nicht unterstützt. Teilzeitstempel sowie die Datumstrennzeichen Bindestrich (-) und Schrägstrich (/) werden unterstützt. Beispiel: 2010-10-22T05:36:24 2010-10-22T05:36 2010-10-22T05 2010-10-22 2010-10 2010 2010/10/22
updatetime	Findet Ressourcen, die an bzw. zu, vor oder nach einem bestimmten Datum oder einer bestimmten Uhrzeit aktualisiert wurden. Beispiel: updatetime:2019-01-01 führt zu Übereinstimmung mit Ressourcen, die am 01.01.2019 aktualisiert wurden. updatetime<2019-02 stimmt mit Ressourcen überein, die vor dem 01.02.2019 um 00:00:00 Uhr aktualisiert wurden. updatetime>2019-02 stimmt mit Ressourcen überein, die nach dem 2019-02-01T00:00:00 aktualisiert wurden. Zeitstempelformat: YYYY-MM-DDThh:mm:ss Alle Zeitstempel müssen in GMT angegeben sein. Zeitzonen werden nicht unterstützt. Teilzeitstempel sowie die Datumstrennzeichen Bindestrich (-) und Schrägstrich (/) werden unterstützt. Beispiel: 2010-10-22T05:36:24 2010-10-22T05:36 2010-10-22T05 2010-10-22 2010-10 2010 2010/10/22
fully_qualified_name:x	Führt zu Übereinstimmung von x mit einem Teilstring von fully_qualified_name.
fully_qualified_name=x	Entspricht x als fully_qualified_name.

Aspektsuche

Wenn Sie nach Einträgen anhand der zugehörigen Aspekte suchen möchten, verwenden Sie die folgende Abfragesyntax.

Hinweis: Beim Abgleich von Teilstrings wird versucht, eine Übereinstimmung mit einer begrenzten Anzahl von Aspekten zu finden. Wenn Sie den Eintrag nicht über ein Fragment des Pfads finden, verwenden Sie den vollständigen Pfad, um die Suche einzugrenzen und die Erinnerung zu erhöhen.

Kennzeichner	Beschreibung
aspect:x	Gleicht x als Teilstring des vollständigen Pfads zum Aspekttyp eines Aspekts ab, der an den Eintrag angehängt ist, im Format projectid.location.ASPECT_TYPE_ID.
aspect=x	Entspricht x als vollständigem Pfad zum Aspekttyp eines Aspekts, der an den Eintrag angehängt ist, im Format projectid.location.ASPECT_TYPE_ID.
aspect:xOPERATORvalue	Sucht nach Werten für das Feld „Seitenverhältnis“. Führt zu Übereinstimmung von x mit einem Teilstring des vollständigen Pfads zum Aspekttyp und Feldnamen eines Aspekts, der an den Eintrag angehängt ist, im Format projectid.location.ASPECT_TYPE_ID.FIELD_NAME. Die Liste der unterstützten Operatoren hängt vom Feldtyp im Aspekt ab: String: = (genaue Übereinstimmung) und : (Teilstring) Alle Zahlentypen: =, :, <, >, <=, >=, =>, =< Enum: = Datum/Uhrzeit: wie bei Zahlen, aber die zu vergleichenden Werte werden als Datums- und Uhrzeitangaben statt als Zahlen behandelt. Boolesch: = Es können nur Felder der obersten Ebene des Aspekts durchsucht werden. Die folgenden Abfragen stimmen beispielsweise alle mit Einträgen überein, bei denen der Wert des Felds is-enrolled im Aspekt employee-info true ist. Es werden auch andere Einträge zurückgegeben, die mit dem Teilstring übereinstimmen. aspect:example-project.us-central1.employee-info.is-enrolled=true aspect:example-project.us-central1.employee=true aspect:employee=true

Logische Operatoren

Eine Abfrage kann aus mehreren Prädikaten bestehen, die mit den logischen Operatoren AND, OR oder NOT verknüpft sind.

• Wenn Sie keinen Operator angeben, wird das logische AND als Operator angenommen. Beispiel: foo bar gibt Ressourcen zurück, die sowohl dem Prädikat foo als auch dem Prädikat bar entsprechen.
• Ein Prädikat kann mit einem Präfix - (Bindestrich) oder NOT negiert werden. Beispiel: -name:foo gibt Ressourcen mit Namen zurück, die nicht dem Prädikat foo entsprechen.

Bei der reinen Keyword-Suche wird bei logischen Operatoren nicht zwischen Groß- und Kleinschreibung unterschieden.

Abgekürzte Syntax

Wenn Sie in Ihren Abfragen eine abgekürzte Syntax verwenden möchten, verwenden Sie | (senkrechter Strich) für OR-Operatoren und , (Komma) für AND-Operatoren. Die abgekürzte Syntax funktioniert für die qualifizierten Prädikate mit Ausnahme von label.

Die folgenden Beispiele zeigen, wie Sie die abgekürzte Syntax für die Suche nur mit Schlüsselwörtern verwenden.

• Mit dem Operator OR nach Einträgen in einem der zahlreichen Projekte suchen

  projectid:(id1|id2|id3|id4)
  

  Dieselbe Suche ohne Verwendung der abgekürzten Syntax sieht so aus:

  projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4
  

• So suchen Sie nach Einträgen mit übereinstimmenden Spaltennamen:

  • UND: column:(name1,name2,name3)
  • ODER: column:(name1|name2|name3)

Nächste Schritte

• Weitere Informationen zur Metadatenverwaltung in Knowledge Catalog
• Einträge und Eintragslinks mithilfe von Aspekten mit Metadaten anreichern
• Einträge verwalten und benutzerdefinierte Quellen aufnehmen