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. Bilgi Kataloğu'nu kullanarak Cloud Firestore meta verilerinizi analiz edebilir ve aşağıdaki gibi görevlerde yardım alabilirsiniz:

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

Knowledge Catalog, yeni ve mevcut Cloud Firestore veritabanlarında varsayılan olarak etkindir ve aşağıdaki meta verileri otomatik olarak alır:

Başlamadan önce

Bilgi Kataloğu analizlerini Cloud Firestore ile kullanmak için öncelikle bir Cloud Firestore veritabanınızın olması gerekir. 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

Bilgi Kataloğu'nda Cloud Firestore meta verilerini aramak ve görüntülemek için sorumluların Cloud Firestore kaynaklarını görüntüleme izni olmalıdır. Bu kaynaklar arasında dataplex.projects.search izni de yer alır.

Kullanıcılar, gruplar veya hizmet hesapları gibi asıl kullanıcılara 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.

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 gerekli roller

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

• Dataplex Catalog Yöneticisi (roles/dataplex.catalogAdmin)
• Dataplex Catalog Editor (roles/dataplex.catalogEditor)
• Dataplex Catalog Viewer (roles/dataplex.catalogViewer)

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

Meta veri keşfi türleri

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

Anahtar kelime ve doğal dil araması

Bilgi Kataloğu, anahtar kelime ve doğal dil aramalarını destekler.

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

Daha fazla bilgi için Bilgi Kataloğu'nda 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 user-firestore-database adlı bir veritabanını ele alalım. Bu veritabanında user-schema adlı bir koleksiyon grubu şemanız var.

Keşif tamamlandıktan sonra, Google Cloud Console'un Bilgi Kataloğu sayfasında veya Bilgi Kataloğu API'sini 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

Özellik türleri, özellikleri için şablon olarak kullanabileceğiniz yeniden kullanılabilir kaynaklardır. Görünüm türleri, iş tekrarını ve eksik görünümleri önlemenize yardımcı olur. İhtiyacınız olan yön türlerini oluşturmak için Bilgi Kataloğu'nu kullanabilirsiniz.

Özel yön türleri oluşturduktan sonra, kaynaklarınıza yönler ekleyebilirsiniz. Kaynaklarınıza yön eklemek, aşağıdakileri yapmanıza olanak tanır:Cloud Firestore

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

Özellik türleri oluşturma ve Cloud Firestore özelliklerini 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 arama

Cloud Firestore öğelerini aramak için Google Cloud Console'daki Bilgi Kataloğu 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 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 araması yapmak için sorguları kullanma

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

Daha fazla bilgi için Bilgi Kataloğu'nda 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 şu şekildedir:

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 şu şekilde görünebilir:

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

Görünüm türüne göre arama

Bilgi Kataloğu, arama yapmak için kullanabileceğiniz birkaç yerleşik yön türü içerir.

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

1. Yönler panelinde Başka yön türleri ekle menüsünü tıklayın.
2. Firestore girin, ardından arama sonuçlarını bu türle sınırlamak için aşağıdaki yön türlerinden birini veya daha fazlasını seçin.
   • Cloud Firestore Veritabanı
   • Cloud Firestore Şema
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ış bölümünde Ekle'yi tıklayın .
   • Öğeye bir yön eklemek için Yönler'de 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şlere gitmek için giriş adını tıklayın.

Cloud Firestore içinde doğal dilde arama

Doğal dil arama (önizleme), semantik sorguları anlamak için yapay zekayı kullanır. Bu sayede, kaynakları günlük dilde arayabilir ve karmaşık söz dizimi kullanma ihtiyacını ortadan kaldırabilirsiniz. Örneğin, List all Firestore collections related to sales gibi sorgular girebilirsiniz.

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

Cloud Firestore içinde söz dizimi arama

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

Daha fazla bilgi için Bilgi Kataloğu'nda 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 ayrıntıları sayfasında Giriş listesi sekmesini, ardından Aramada tüm alt girişleri göster'i 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. Bilgi Kataloğu, 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ı: Veritabanına yön türü eklemek için Yön ekle düğmesini tıklayın.

Fiyatlandırma

Cloud Firestore teknik meta verilerinin Knowledge Catalog'da depolanması ücretsizdir. API çağrıları ve ek iş meta verileri zenginleştirme için standart Knowledge Catalog fiyatlandırması geçerlidir. Daha fazla bilgi için Knowledge Catalog fiyatlandırma sayfasına bakın.

Sınırlamalar

• 10.000 koleksiyon grubu alındıktan sonra sorgu sonuçları kısaltılır.
• Toplu alım sırasında, veritabanınızdaki güncellemelerin Bilgi Kataloğu'na yansıması 48 saati bulabilir.
• Canlı alım sırasında, veritabanınızdaki güncellemelerin Bilgi Kataloğu'na yansıtılması 5 dakikayı bulabilir.
• Koleksiyon grupları, canlı alım sırasında güncellenmez.
• Koleksiyon grubu şemaları, canlı alım 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ı alımdan 24 ila 48 saat sonra güncellenir.
• Ayıklama işlemi birkaç dakika sürebilir.

Sırada ne var?

• Bilgi Kataloğu'nda veri kataloğu yönetimi hakkında
• Knowledge Catalog kimlik ve erişim yönetimi rolleri