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

Meta verilerinizi depolama, yönetme ve bunlara erişme platformu olan Knowledge Catalog'u kullanarak Cloud Firestore kaynaklarınızı arayabilir ve yönetebilirsiniz. Cloud Firestore meta verilerinizi analiz etmek ve aşağıdaki gibi görevlerde yardımcı olması için Bilgi Kataloğu'nu kullanabilirsiniz:

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

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

Başlamadan önce

• API'leri etkinleştirebilmek için roles/serviceusage.serviceUsageAdmin hizmet kullanım yöneticisi IAM rolüne sahip olmanız gerekir. Bu rol, serviceusage.services.enable iznini içerir. Rolleri nasıl atayacağınızı öğrenin.
• API'yi etkinleştirmek için API'leri etkinleştirme başlıklı makaleyi inceleyin.

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

Cloud Firestore meta verilerini Knowledge Catalog'da aramak ve görüntülemek için sorumluların Cloud Firestore kaynaklarını görüntüleme izni olmalıdır. Bu izin, dataplex.projects.search iznini de içerir.

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

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

• Dataplex Catalog Admin (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 varlıklarını 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 Cloud Firestore gibi bağlı veri kaynaklarını 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, Cloud Firestore veritabanlarının tümünü görüntülemek için system=Firestore AND type=Database 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'nun 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 şeması var.

Keşif tamamlandıktan sonra bu öğeleri (user-firestore-database ve user-schema) Google Cloud Console'un Bilgi Kataloğu sayfasında veya Bilgi Kataloğu API'sini kullanarak 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 yönleri Cloud Firestore kaynaklarınıza ekleyebilirsiniz. Özellikleri kaynaklarınıza ekleyerek şunları yapabilirsiniz:

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

En boy türleri oluşturma ve en boyları Cloud Firestore ekleme hakkında daha fazla bilgi edinmek için En boyları 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, tüm Cloud Firestore veritabanlarını görüntülemek için system=Firestore AND type=Database girebilirsiniz.

Daha fazla bilgi için Bilgi Kataloğu'nun 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 öğe 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 dilinde 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'nun 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, Cloud Firestore veritabanlarının tümünü görüntülemek için system=Firestore AND type=Database girebilirsiniz.

Daha fazla bilgi için Bilgi Kataloğu'nun 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ı bilgi edinmek 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 girin.

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

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

Sınırlamalar

• 10.000 koleksiyon grubu alındıktan sonra sorgu sonuçları kesilir.
• 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 Identity and Access Management rolleri