Bilgi Kataloğu analizlerini görüntüleme

Meta verilerinizi depolamak, yönetmek ve bunlara erişmek için kullanılan bir platform olan Knowledge Catalog'u kullanarak Cloud Firestore kaynaklarınızı arayabilir ve yönetebilirsiniz. Knowledge Catalog'u kullanarak Cloud Firestore meta verilerinizi analiz edebilir ve aşağıdaki gibi görevlerde yardım alabilirsiniz:

  • Bağımlılıklar ve bir kullanım alanına uygunluk dahil olmak üzere analiz
  • Değişiklik yönetimi
  • Şema evrimi

Bilgi Kataloğu, yeni ve mevcut veritabanlarında varsayılan olarak etkindir. Cloud Firestore Aşağıdaki meta verileri otomatik olarak alır:

Kaynak Tür Alanlar
Veritabanı Kontrol düzlemi
  • Sürüm
  • Modlar
  • Konum (çoklu bölgeler dahil)
  • Proje kimliği
  • Veritabanı adı
  • Oluşturulma tarihi
Veritabanı şeması Veri düzlemi
  • Ad
  • Toplama
  • Alan - Veri Türleri
  • Şema

Başlamadan önce

Knowledge Catalog API'yi (dataplex.googleapis.com) etkinleştirin.

Bilgi Kataloğu analizlerini Cloud Firestore ile kullanmak için öncelikle bir Cloud Firestore veritabanınız olmalıdır. Daha fazla bilgi için Veritabanı oluşturma ve yönetme başlıklı makaleyi inceleyin.

Arama sonuçlarına erişmek için gereken roller

Knowledge Catalog'da Cloud Firestore meta verilerini aramak ve görüntülemek için, alt hesapların dataplex.projects.search izni de dahil olmak üzere Cloud Firestore kaynaklarını görüntüleme izinlerine sahip olması gerekir.

Kullanıcılar, gruplar veya hizmet hesapları gibi ana hesaplara bu izinleri vermek için Cloud Firestore kaynaklarını içeren projede Cloud Datastore Görüntüleyici (roles/datastore.viewer) IAM rolünü atayın.

Bilgi Kataloğu işlemi Cloud Firestore kaynak Gerekli roller veya izinler
Cloud Firestore kaynaklarını arayın Veritabanı datastore.databases.getMetadata
Veritabanı şeması datastore.schemas.get

Rol verme hakkında daha fazla bilgi için Erişimi yönetme başlıklı makaleyi inceleyin. Cloud Firestore IAM rolleri hakkında daha fazla bilgi için Cloud Firestore rolleri ve izinleri başlıklı makaleyi inceleyin.

Girişleri aramak için gereken roller

Girişleri aramak için arama için kullanılan projede aşağıdaki IAM rollerinden en az birine sahip olmanız gerekir:

Arama sonuçlarındaki izinler, seçilen projeden bağımsız olarak kontrol edilir. Daha fazla bilgi için Knowledge Catalog ile veri öğelerini arama başlıklı makaleyi inceleyin.

Meta veri keşfi türleri

Knowledge Catalog meta veri keşfi, veri varlıklarını (koleksiyonlar ve veritabanları gibi) tanımlamak ve şemalar, açıklamalar ve konumlar gibi teknik meta verilerini Knowledge Catalog kataloğuna ayıklamak için bağlı veri kaynaklarını (Cloud Firestore gibi) tarayan otomatik bir işlemdir. Bu işlem, kataloğu kaynak sistemlerle senkronize tutmak için düzenli olarak çalıştırılır.

Knowledge Catalog, anahtar kelime ve doğal dilde aramaları destekler.

  • Anahtar kelime araması, belirli anahtar kelimeler, filtreler ve tanımlanmış bir söz dizimi kullanarak kaynakları bulmanıza olanak tanır. Örneğin, tüm Cloud Firestore veritabanlarını görüntülemek için system=Firestore AND type=Database yazabilirsiniz.
  • Doğal dilde arama (Önizleme), semantik sorguları anlamak için yapay zekayı kullanır. Karmaşık söz dizimi kullanma ihtiyacını ortadan kaldırarak günlük dille kaynakları bulmanızı sağlar. Örneğin, List all Firestore databases related to sales gibi sorgular girebilirsiniz.

Daha fazla bilgi için Bilgi Kataloğu için arama söz dizimi başlıklı makaleyi inceleyin.

Örnek: Cloud Firestore koleksiyon grubu şemasını keşfetme

Meta veri keşif sürecini anlamak için Cloud Firestore adlı bir veritabanını user-firestore-databaseele alalım. Bu veritabanında user-schema adlı bir koleksiyon grubu şeması var.

Keşif tamamlandıktan sonra Google Cloud Console'un Knowledge Catalog sayfasında veya Knowledge Catalog API'yi kullanarak bu öğeleri (user-firestore-database ve user-schema) arayabilirsiniz. Ardından, öğelerle ilgili ayrıntıları görüntüleyebilir ve bunları ek işletme veya operasyonel meta verilerle zenginleştirebilirsiniz.

Yönleri kullanarak meta verileri zenginleştirme

Yön türleri, yönler için şablon olarak kullanabileceğiniz yeniden kullanılabilir kaynaklardır. Yön türleri, yinelenen çalışmalardan ve eksik yönlerden kaçınmanıza yardımcı olur. İhtiyacınız olan özellik türlerini oluşturmak için Knowledge Catalog'u kullanabilirsiniz.

Özel özellik türleri oluşturduktan sonra Cloud Firestore kaynaklarınıza özellik ekleyebilirsiniz. Kaynaklarınıza yönler ekleyerek şunları yapabilirsiniz:

  • Öğelere işletme meta verileri ekleme
  • Öğeleri işletme meta verilerine ve diğer özel meta verilere göre arama

Özellik türleri oluşturma ve Cloud Firestore öğesine özellik ekleme hakkında daha fazla bilgi edinmek için Özellikleri yönetme ve meta verileri zenginleştirme başlıklı makaleyi inceleyin.

Cloud Firestore öğelerini arayın

Cloud Firestore öğelerini aramak için Google Cloud Console'daki Knowledge Catalog arama sayfasını kullanın.

  1. Bilgi Kataloğu Arama sayfasına gidin.

    Arama'ya git

  2. Filtreler panelinde Sistemler'i tıklayın ve ardından Firestore'u seçin.

  3. İsteğe bağlı. Tür takma adları bölümünde, aşağıdaki tür takma adlarından birini veya daha fazlasını seçerek arama sonuçlarını belirli bir Cloud Firestore öğe türüne göre filtreleyebilirsiniz:

    • Veritabanı
    • Veritabanı şeması
    • Diğer

Anahtar kelime arama sorguları gerçekleştirmek için Bilgi Kataloğu'ndaki arama alanını kullanabilirsiniz. Örneğin, tüm Cloud Firestore veritabanlarını görüntülemek için system=Firestore AND type=Database yazabilirsiniz.

Daha fazla bilgi için Bilgi Kataloğu için arama söz dizimi başlıklı makaleyi inceleyin.

Tüm Cloud Firestore öğelerini görüntülemek için system=Firestore girin. Belirli anahtar kelimeler girebilirsiniz. Örneğin, tüm Cloud Firestore veritabanlarını görüntülemek için:

system=Firestore AND type=Database

Karmaşık ifadeler için parantezleri ve AND ile OR mantıksal operatörlerini de kullanabilirsiniz. Arama alanında kullanabileceğiniz ifadeler hakkında daha fazla bilgi edinmek için Bilgi Kataloğu için arama söz dizimi başlıklı makaleyi inceleyin.

Belirli Cloud Firestore öğeleri için arama sorgularını doğrudan arama alanına girebilirsiniz. Sorgu dizesinin biçimi aşağıdaki gibidir:

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

Aşağıdakini değiştirin:

  • QUERY_STRING: Sorgulamak istediğiniz Cloud Firestore öğesinin türüne göre bir sorgu dizesi belirlemek için aşağıdaki listeyi kullanın:

    • firestore-database
    • firestore-schema

Örnek bir sorgu aşağıdaki gibi görünebilir:

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

Yön türüne göre arama

Knowledge Catalog, arama yapmak için kullanabileceğiniz birkaç yerleşik özellik türü içerir.

Yön türüne göre arama yapmak için aşağıdaki adımları uygulayın:

  1. Yönler panelinde Daha fazla yön türü ekle menüsünü tıklayın.
  2. Firestore yazın, ardından arama sonuçlarını ilgili türle sınırlamak için aşağıdaki özellik türlerinden birini veya daha fazlasını seçin.
    • Cloud Firestore Veritabanı
    • Cloud Firestore Şeması
  3. Tamam'ı tıklayın.
  4. Sonuçlar tablosunda, öğenin meta verilerini görüntülemek için öğenin adını tıklayın.
  5. İsteğe bağlı: Öğelerinizi iyileştirin veya görüntüleyin. Aşağıdakilerden herhangi birini yapabilirsiniz:
    • Öğeye zengin metin açıklaması eklemek için Genel Bakış'ta Ekle'yi tıklayın .
    • Öğeye bir özellik eklemek için Özellikler bölümünde Ekle'yi tıklayın .
    • Bir örneğin üye veritabanlarını görüntülemek için Giriş Listesi sekmesini ve ardından Aramada tüm alt girişleri göster'i tıklayın.
    • Giriş ayrıntıları bölümünde öğenin tüm ayrıntılarını görüntüleyin. Ek girişleri görmek için giriş adını tıklayın.

Cloud Firestore uygulamasında doğal dilde arama

Doğal dilde arama (Önizleme), semantik sorguları anlamak için yapay zekayı kullanır. Karmaşık söz dizimi kullanma ihtiyacını ortadan kaldırarak günlük dille kaynakları bulmanızı sağlar. Örneğin, List all Firestore collections related to sales gibi sorgular girebilirsiniz.

Daha fazla bilgi için Bilgi Kataloğu için arama söz dizimi başlıklı makaleyi inceleyin.

Cloud Firestore içinde söz dizimi araması

Anahtar kelime araması, belirli anahtar kelimeler, filtreler ve tanımlanmış bir söz dizimi kullanarak kaynakları bulmanıza olanak tanır. Örneğin, tüm Cloud Firestore veritabanlarını görüntülemek için system=Firestore AND type=Database yazabilirsiniz.

Daha fazla bilgi için Bilgi Kataloğu için arama söz dizimi başlıklı makaleyi inceleyin.

Örnek iş akışı: Veritabanından şemaya ayrıntılı inceleme

Bir veritabanından şemaya ayrıntılı inceleme yapmak için aşağıdaki adımları uygulayın:

  1. Bilgi Kataloğu Arama sayfasına gidin.

    Arama'ya git

  2. Filtreler panelinde Sistemler'i ve ardından Firestore'u seçin. Alternatif olarak, arama alanına system=Firestore yazın.

  3. Bir veritabanı seçin.

  4. Firestore details (Firestore ayrıntıları) sayfasında Entry list (Giriş listesi) sekmesini, ardından Show all children entries in search'ü (Aramada tüm alt girişleri göster) tıklayın.

  5. Firestore veritabanı ayrıntıları sayfasında Giriş listesi sekmesini, ardından Aramada tüm alt girişleri göster'i tıklayın. Knowledge Catalog, veritabanındaki koleksiyon gruplarını gösterir.

  6. Bir koleksiyon grubu adı seçin ve ardından Koleksiyon grubu ayrıntıları sayfasında şemayı görüntülemek için Şema'yı tıklayın.

  7. İsteğe bağlı: Bir veritabanına yön türü eklemek için Yön ekle düğmesini tıklayın.

Fiyatlandırma

Bilgi Kataloğu'nda Cloud Firestore teknik meta verilerini depolamak için herhangi bir ücret alınmaz. API çağrıları ve ek işletme meta verileri zenginleştirmesi için standart Knowledge Catalog fiyatlandırması geçerlidir. Daha fazla bilgi için Knowledge Catalog fiyatlandırma sayfasını inceleyin.

Sınırlamalar

  • Sorgu sonuçları,10.000 koleksiyon grubu alındıktan sonra kesilir.
  • Toplu besleme sırasında, veritabanınızdaki güncellemelerin Bilgi Kataloğu'na yansıtılması 48 saati bulabilir.
  • Canlı besleme sırasında, veritabanınızda yapılan güncellemelerin Knowledge Catalog'a yansıtılması 5 dakikayı bulabilir.
  • Koleksiyon grupları, canlı besleme sırasında güncellenmez.
  • Koleksiyon grubu şemaları, canlı besleme sırasında güncellenir ancak bu güncelleme yalnızca alfabetik sıraya göre ilk 100 üst düzey temel alanı kapsar. Kalan şema bilgileri, canlı beslemeden 24 ila 48 saat sonra güncellenir.
  • Ayıklama işlemi birkaç dakika sürebilir.

Sırada ne var?