שימוש בחיפוש לפי מילות מפתח בלבד ב-Knowledge Catalog

אפשר להשתמש בחיפוש לפי מילות מפתח בלבד ב-Knowledge Catalog כדי למצוא משאבים באמצעות מילות מפתח ספציפיות, מסננים ותחביר מוגדר. חיפוש לפי מילות מפתח בלבד מאפשר שליטה מדויקת בשאילתות החיפוש, ומאפשר לצמצם את התוצאות על סמך שדות מטא-נתונים.

לפני שמתחילים

לפני שמבצעים חיפוש, צריך לוודא שהוקצו לכם התפקידים הנדרשים ושהפעלתם את ה-API הדרוש.

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות בשביל לחפש רשומות ולגשת לתוצאות החיפוש ב-Knowledge Catalog, אתם צריכים לבקש מהאדמין לתת לכם את התפקידים הבאים ב-IAM:

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

שימוש בחיפוש לפי מילות מפתח בלבד

המסוף

כדי לחפש משאבים באמצעות חיפוש מילות מפתח, פועלים לפי השלבים הבאים:

  1. במסוף Google Cloud , עוברים לדף Search ב-Knowledge Catalog.

    מעבר אל חיפוש

  2. אם פלטפורמת החיפוש מוגדרת כקטלוג נתונים, בתפריט בחירת פלטפורמת חיפוש בוחרים באפשרות Knowledge Catalog.

  3. בשדה Find resources across projects (חיפוש משאבים בכל הפרויקטים), מזינים את השאילתה.

  4. כדי לצמצם את החיפוש, משתמשים בחלונית Filters. אלה המסננים שזמינים:

    • מערכות: רשימה של מערכות זמינות, כמו BigQuery או Cloud SQL. מערכת Knowledge Catalog מכילה רשומות מותאמות אישית.
    • היבטים (תגים) מאפשרים לכם לשלוח שאילתות לגבי נכסים שתויגו באמצעות תבנית ספציפית. אפשר להשתמש בתפריט התאמה אישית כדי לצמצם עוד יותר את התוצאות ולסנן לפי ערכים ספציפיים של היבטים.
    • פרויקט: רשימת הפרויקטים שאפשר להגדיר את היקף החיפוש שלהם.
    • כינויי סוגים הם סוגי נתונים שמשויכים לסוג רשומה. יכול להיות שסוג הרשומה יהיה projects/test-project/locations/us/entryTypes/my-entry-type, אבל אפשר לחפש אותה באמצעות הכינויים שלה TABLE או DATABASE. אפשר להגדיר כינוי אחד או יותר לסוג כשיוצרים או מעדכנים סוג רשומה.
    • מערכי נתונים מגיעים מ-BigQuery.

    אפשר להוסיף ידנית את המסננים הבאים:

    • כדי להוסיף מסנן פרויקט: בקטע פרויקט, לוחצים על הוספת פרויקט. מחפשים פרויקט ספציפי, בוחרים את הפרויקט ולוחצים על Open.
    • כדי להוסיף מסנן של סוג היבט: בקטע היבטים, לוחצים על התפריט הוספת סוגים נוספים של היבטים. מחפשים תבנית ספציפית, בוחרים אותה ולוחצים על אישור.
  5. אופציונלי: בנוסף לנכסים שזמינים לכם, אתם יכולים לחפש משאבים שזמינים לכולם ב- Google Cloud על ידי בחירה באפשרות Include public datasets (הכללת מערכי נתונים ציבוריים).

    הטיפים הבאים יעזרו לכם ליצור שאילתת חיפוש:

    • אם הביטוי לחיפוש מכיל רווחים, צריך להקיף אותו במירכאות. לדוגמה, "search terms".
    • מוסיפים NOT לפני מילת מפתח כדי להתאים לשלילה הלוגית של המסנן keyword:term. אפשר גם להשתמש באופרטורים בוליאניים AND ו-OR כדי לשלב ביטויי חיפוש. האופרטורים AND, OR ו-NOT לא תלויי אותיות רישיות (case-sensitive).

    לדוגמה, NOT column:term מפרטת את כל העמודות מלבד אלה שתואמות למונח שצוין.

  6. כדי לראות מידע נוסף על המשאב שחיפשתם, לוחצים על שם המשאב בתוצאות החיפוש. ייפתח דף הפרטים של הרשומה.

gcloud

כדי לחפש משאבים, משתמשים בפקודה gcloud dataplex entries search.

C#‎

C#

לפני שמנסים את הדוגמה הזו, צריך לפעול לפי C#ההוראות להגדרה במאמר מדריך למתחילים לעבודה עם Knowledge Catalog באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Knowledge Catalog C# API.

כדי לבצע אימות לקטלוג הידע, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.

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,
        };