مشاهده بینش‌های کاتالوگ دانش

شما می‌توانید با استفاده از Knowledge Catalog که بستری برای ذخیره‌سازی، مدیریت و دسترسی به فراداده‌های شماست، منابع Cloud Firestore خود را جستجو و مدیریت کنید. می‌توانید از Knowledge Catalog برای تجزیه و تحلیل فراداده‌های Cloud Firestore خود استفاده کنید و به انجام وظایفی مانند موارد زیر کمک کنید:

  • تحلیل، شامل وابستگی‌ها و مناسب بودن برای یک مورد استفاده
  • مدیریت تغییر
  • تکامل طرحواره

کاتالوگ دانش به طور پیش‌فرض در پایگاه‌های داده جدید و موجود Cloud Firestore فعال است و به طور خودکار فراداده‌های زیر را بازیابی می‌کند:

منبع نوع فیلدها
پایگاه داده صفحه کنترل
  • نسخه
  • حالت(ها)
  • موقعیت مکانی (شامل چند منطقه)
  • شناسه پروژه
  • نام پایگاه داده
  • زمان ایجاد شده
طرحواره پایگاه داده صفحه داده
  • نام
  • مجموعه
  • فیلد - نوع(های) داده
  • طرحواره

قبل از اینکه شروع کنی

برای استفاده از بینش‌های کاتالوگ دانش با Cloud Firestore ، ابتدا باید یک پایگاه داده Cloud Firestore داشته باشید. برای اطلاعات بیشتر، به ایجاد و مدیریت پایگاه‌های داده مراجعه کنید.

نقش‌های مورد نیاز برای دسترسی به نتایج جستجو

برای جستجو و مشاهده فراداده‌های Cloud Firestore در Knowledge Catalog، مدیران باید مجوزهایی برای مشاهده منابع Cloud Firestore ، از جمله مجوز dataplex.projects.search ، داشته باشند.

برای اعطای این مجوزها به مدیران - مانند کاربران، گروه‌ها یا حساب‌های سرویس - نقش IAM مربوط به Cloud Datastore Viewer ( roles/datastore.viewer ) را در پروژه‌ای که شامل منابع Cloud Firestore است، به آنها اختصاص دهید.

عملیات کاتالوگ دانش منبع Cloud Firestore نقش‌ها یا مجوزهای مورد نیاز
جستجوی منابع Cloud Firestore پایگاه داده datastore.databases.getMetadata
طرحواره پایگاه داده datastore.schemas.get

برای اطلاعات بیشتر در مورد اعطای نقش‌ها، به مدیریت دسترسی مراجعه کنید. برای اطلاعات بیشتر در مورد نقش‌های Cloud Firestore IAM، به نقش‌ها و مجوزهای Cloud Firestore مراجعه کنید.

نقش‌های مورد نیاز برای جستجوی ورودی‌ها

برای جستجوی ورودی‌ها، حداقل به یکی از نقش‌های IAM زیر در پروژه که برای جستجو استفاده می‌شود، نیاز دارید:

مجوزهای نتایج جستجو مستقل از پروژه انتخاب شده بررسی می‌شوند. برای اطلاعات بیشتر، به «جستجوی دارایی‌های داده با کاتالوگ دانش» مراجعه کنید.

انواع کشف فراداده

کشف فراداده کاتالوگ دانش یک فرآیند خودکار است که منابع داده متصل - مانند Cloud Firestore - را اسکن می‌کند تا دارایی‌های داده (مانند مجموعه‌ها و پایگاه‌های داده) را شناسایی کرده و فراداده‌های فنی آنها مانند طرحواره‌ها، توضیحات و مکان‌ها را در کاتالوگ کاتالوگ دانش استخراج کند. این فرآیند به صورت دوره‌ای اجرا می‌شود تا کاتالوگ با سیستم‌های منبع هماهنگ بماند.

کاتالوگ دانش از جستجوی کلمات کلیدی و زبان طبیعی پشتیبانی می‌کند.

  • جستجوی کلمات کلیدی به شما امکان می‌دهد منابع را با استفاده از کلمات کلیدی خاص، فیلترها و یک سینتکس تعریف‌شده پیدا کنید. برای مثال، می‌توانید system=Firestore AND type=Database برای مشاهده همه پایگاه‌های داده Cloud Firestore وارد کنید.
  • جستجوی زبان طبیعی (پیش‌نمایش) از هوش مصنوعی برای درک پرسش‌های معنایی استفاده می‌کند. این امکان را به شما می‌دهد تا منابع را با استفاده از زبان روزمره پیدا کنید و نیاز به نحو پیچیده را از بین ببرید. به عنوان مثال، می‌توانید پرسش‌هایی مانند List all Firestore databases related to sales را وارد کنید.

برای اطلاعات بیشتر، به بخش «نحو جستجوی کاتالوگ دانش» مراجعه کنید.

مثال: طرحواره گروه مجموعه Cloud Firestore را کشف کنید

برای درک فرآیند کشف فراداده، یک پایگاه داده Cloud Firestore با نام user-firestore-database را در نظر بگیرید. در این پایگاه داده، شما یک طرحواره گروه مجموعه با نام user-schema دارید.

پس از تکمیل فرآیند کشف، می‌توانید این دارایی‌ها - user-firestore-database و user-schema - را در صفحه Knowledge Catalog کنسول Google Cloud یا با استفاده از Knowledge Catalog API جستجو کنید. سپس می‌توانید جزئیات مربوط به دارایی‌ها را مشاهده کرده و آنها را با فراداده‌های تجاری یا عملیاتی اضافی غنی کنید.

غنی‌سازی فراداده با استفاده از aspectها

انواع جنبه‌ها منابع قابل استفاده مجددی هستند که می‌توانید به عنوان الگو برای جنبه‌ها از آنها استفاده کنید. انواع جنبه‌ها به شما کمک می‌کنند از تکرار کار و جنبه‌های ناقص جلوگیری کنید. می‌توانید از کاتالوگ دانش برای ایجاد انواع جنبه‌های مورد نیاز خود استفاده کنید.

پس از ایجاد انواع جنبه‌های سفارشی، می‌توانید جنبه‌ها را به منابع Cloud Firestore خود متصل کنید. اتصال جنبه‌ها به منابع به شما امکان می‌دهد موارد زیر را انجام دهید:

  • افزودن فراداده‌های تجاری به دارایی‌ها
  • جستجوی دارایی‌ها بر اساس فراداده‌های تجاری و سایر فراداده‌های سفارشی

برای کسب اطلاعات بیشتر در مورد ایجاد انواع جنبه‌ها و اتصال جنبه‌ها به Cloud Firestore ، به مدیریت جنبه‌ها و غنی‌سازی فراداده مراجعه کنید.

جستجوی دارایی‌های Cloud Firestore

برای جستجوی دارایی‌های Cloud Firestore از صفحه جستجوی کاتالوگ دانش در کنسول Google Cloud استفاده کنید.

  1. به صفحه جستجوی کاتالوگ دانش بروید.

    به جستجو بروید

  2. در پنل فیلترها ، روی Systems کلیک کنید و سپس Firestore را انتخاب کنید.

  3. اختیاری. در قسمت Type aliases ، می‌توانید با انتخاب یک یا چند مورد از انواع مستعار زیر، نتایج جستجو را به نوع خاصی از دارایی Cloud Firestore فیلتر کنید:

    • پایگاه داده
    • طرحواره پایگاه داده
    • دیگر

شما می‌توانید از فیلد جستجو در Knowledge Catalog برای انجام جستجوهای کلمات کلیدی استفاده کنید. برای مثال، می‌توانید system=Firestore AND type=Database را برای مشاهده همه پایگاه‌های داده Cloud Firestore وارد کنید.

برای اطلاعات بیشتر، به بخش «نحو جستجوی کاتالوگ دانش» مراجعه کنید.

برای مشاهده همه دارایی‌های Cloud Firestore ، system=Firestore را وارد کنید. می‌توانید کلمات کلیدی خاصی را وارد کنید. به عنوان مثال، برای مشاهده همه پایگاه‌های داده Cloud Firestore :

system=Firestore AND type=Database

همچنین می‌توانید از پرانتز و عملگرهای منطقی AND و OR برای عبارات پیچیده استفاده کنید. برای کسب اطلاعات بیشتر در مورد عباراتی که می‌توانید در فیلد جستجو استفاده کنید، به بخش «نحو جستجوی کاتالوگ دانش» مراجعه کنید.

شما می‌توانید مستقیماً عبارات جستجو برای دارایی‌های خاص Cloud Firestore را در فیلد جستجو وارد کنید. قالب رشته جستجو به شرح زیر است:

type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

موارد زیر را جایگزین کنید:

  • QUERY_STRING : از لیست زیر برای شناسایی یک رشته پرس و جو بر اساس نوع دارایی Cloud Firestore که می‌خواهید پرس و جو کنید، استفاده کنید:

    • firestore-database
    • firestore-schema

یک نمونه پرس و جو ممکن است شبیه به موارد زیر باشد:

type="projects/1234567890/locations/global/entryTypes/firestore-schema"

جستجو بر اساس نوع جنبه

کاتالوگ دانش شامل چند نوع جنبه داخلی است که می‌توانید برای انجام جستجوها از آنها استفاده کنید.

برای جستجو بر اساس نوع جنبه، مراحل زیر را دنبال کنید:

  1. در پنل Aspects ، روی منوی Add more aspect types کلیک کنید.
  2. Firestore را وارد کنید، سپس یک یا چند نوع از جنبه‌های زیر را انتخاب کنید تا نتایج جستجو به آن نوع محدود شود.
    • پایگاه داده Cloud Firestore
    • طرحواره Cloud Firestore
  3. روی تأیید کلیک کنید.
  4. در جدول نتایج، روی نام دارایی کلیک کنید تا فراداده‌های آن دارایی را مشاهده کنید.
  5. اختیاری: دارایی‌های خود را بهبود بخشیده یا مشاهده کنید. می‌توانید هر یک از موارد زیر را انجام دهید:
    • برای افزودن توضیحات متنی غنی از دارایی، در نمای کلی ، روی افزودن کلیک کنید.
    • برای افزودن یک جنبه به دارایی، در Aspects ، روی Add کلیک کنید.
    • برای مشاهده پایگاه‌های داده اعضا به عنوان نمونه، روی برگه فهرست ورودی‌ها کلیک کنید و سپس روی نمایش همه ورودی‌های فرزند در جستجو کلیک کنید.
    • در جزئیات ورودی ، جزئیات کامل دارایی را مشاهده کنید. برای مشاهده ورودی‌های بیشتر، روی نام ورودی کلیک کنید.

جستجوی زبان طبیعی در Cloud Firestore

جستجوی زبان طبیعی (پیش‌نمایش) از هوش مصنوعی برای درک پرسش‌های معنایی استفاده می‌کند. این امکان را به شما می‌دهد تا منابع را با استفاده از زبان روزمره پیدا کنید و نیاز به نحو پیچیده را از بین ببرید. به عنوان مثال، می‌توانید پرسش‌هایی مانند List all Firestore collections related to sales را وارد کنید.

برای اطلاعات بیشتر، به بخش «نحو جستجوی کاتالوگ دانش» مراجعه کنید.

جستجوی نحوی در Cloud Firestore

جستجوی کلمات کلیدی به شما امکان می‌دهد منابع را با استفاده از کلمات کلیدی خاص، فیلترها و یک سینتکس تعریف‌شده پیدا کنید. برای مثال، می‌توانید system=Firestore AND type=Database برای مشاهده همه پایگاه‌های داده Cloud Firestore وارد کنید.

برای اطلاعات بیشتر، به بخش «نحو جستجوی کاتالوگ دانش» مراجعه کنید.

نمونه گردش کار: حرکت از پایگاه داده به سمت طرحواره

برای حرکت از یک پایگاه داده به یک طرحواره، مراحل زیر را دنبال کنید:

  1. به صفحه جستجوی کاتالوگ دانش بروید.

    به جستجو بروید

  2. در پنل فیلترها ، گزینه‌ی Systems و سپس Firestore را انتخاب کنید. روش دیگر این است که در فیلد جستجو system=Firestore را وارد کنید.

  3. یک پایگاه داده انتخاب کنید.

  4. در صفحه جزئیات Firestore ، روی برگه فهرست ورودی‌ها کلیک کنید و سپس روی نمایش همه ورودی‌های فرزند در جستجو کلیک کنید.

  5. در صفحه جزئیات پایگاه داده Firestore ، روی برگه فهرست ورودی‌ها کلیک کنید و سپس روی نمایش همه ورودی‌های فرزند در جستجو کلیک کنید. فهرست دانش، گروه‌های مجموعه را در پایگاه داده نمایش می‌دهد.

  6. نام گروه مجموعه را انتخاب کنید و سپس در صفحه جزئیات گروه مجموعه ، برای مشاهده طرحواره، روی طرحواره کلیک کنید.

  7. اختیاری: برای افزودن یک نوع جنبه به پایگاه داده، روی دکمه افزودن جنبه کلیک کنید.

قیمت‌گذاری

هیچ هزینه‌ای برای ذخیره فراداده‌های فنی Cloud Firestore در Knowledge Catalog وجود ندارد. قیمت استاندارد Knowledge Catalog برای فراخوانی‌های API و غنی‌سازی‌های اضافی فراداده‌های تجاری اعمال می‌شود. برای اطلاعات بیشتر، به صفحه قیمت‌گذاری Knowledge Catalog مراجعه کنید.

محدودیت‌ها

  • نتایج پرس‌وجو پس از دریافت ۱۰،۰۰۰ گروه جمع‌آوری، کوتاه می‌شوند.
  • در طول دریافت دسته‌ای، ممکن است تا ۴۸ ساعت طول بکشد تا به‌روزرسانی‌های پایگاه داده شما در کاتالوگ دانش منعکس شود.
  • در طول دریافت زنده، ممکن است تا ۵ دقیقه طول بکشد تا به‌روزرسانی‌های پایگاه داده شما در کاتالوگ دانش منعکس شود.
  • گروه‌های جمع‌آوری در طول مصرف زنده به‌روزرسانی نمی‌شوند.
  • طرحواره‌های گروه مجموعه در طول مصرف زنده به‌روزرسانی می‌شوند، با این حال، این به‌روزرسانی تنها ۱۰۰ فیلد اولیه سطح بالا را به ترتیب حروف الفبا پوشش می‌دهد. اطلاعات طرحواره باقی‌مانده ۲۴ تا ۴۸ ساعت پس از مصرف زنده به‌روزرسانی می‌شوند.
  • فرآیند استخراج ممکن است چند دقیقه طول بکشد.

قدم بعدی چیست؟