Aracılığıyla paylaş

komut

GraphQL şema dosyasını dışarı aktarın veya oluşturun ve diske kaydedin. İki mod desteklenir:

  • Geçici bir DAB çalışma zamanı örneğinden mevcut şemayı getirme
  • Örnekleme kullanarak NoSQL verileri için Cosmos DB'den şema oluşturma

Sözdizimi

dab export --graphql -o <output-directory> [options]

Önemli

Geçerli bir DAB yapılandırması gerektirir. Veritabanı türü yapılandırma dosyasından okunur. Bayrak kabul edilir.

Hızlı bakış

Seçenek Gerekli Varsayılan Geçerli -dir
--graphql Hayır* false Şema dışarı aktarma için ayarlanmalıdır
-o, --output <dir> Yes – Çıktı şeması dizini
-g, --graphql-schema-file <name> Hayı schema.gql Çıktı dir içine yerleştirilen dosya adı
--generate Hayı false Cosmos DB verilerinden şema oluşturma
-m, --sampling-mode <mode> Hayı TopNExtractor Bunlardan biri: , ,
-n, --sampling-count <int> Hayı Moda bağımlı Mod başına kayıt sayısı
--sampling-partition-key-path <path> Hayı – Yalnızca
-d, --sampling-days <int> Hayı Moda bağımlı N günden daha yeni kayıtlara kısıtlama
--sampling-group-count <int> Hayı (TimePartitionedSampler) Yalnızca
-c, --config <file> Hayı Env'ye özgü veya Yapılandırma dosyasının yolu
--help Hayı – Yardım ekranını görüntüleme
--version Hayı – Sürüm bilgilerini görüntüleme

ayrıştırıcı gerekli değildir, ancak siz sağlamadığınız sürece dışarı aktarma işlemi başarısız olur.

Davranış

Mode Description
Mevcut şemayı dışarı aktarma Geçici bir çalışma zamanı başlatır, GraphQL şemasını gözden geçirin, dosyayı yazar
Şema oluşturma NoSQL belgeleri ve çıkarım şeması için örnekler Azure Cosmos DB

Dışarı aktarma modunda (olmadan ), DAB ilk olarak dener ve öğesine geri döner.

Dışarı aktarma modu şema alma işlemini en fazla beş kez yeniden denenir. Oluşturma modu tek bir deneme kullanır.

Boş şema şu hatayla sonuçlanır: "Oluşturulan GraphQL şeması boş. Şemayı oluşturmak için verilerin kullanılabilir olduğundan emin olun."

Örnekleme modları

TopNExtractor

  • Örnekler N son belgeler
  • ile isteğe bağlı zaman filtresi

Daha küçük, tekdüzen veri kümeleri için kullanın

EligibleDataSampler

  • Bölüme duyarlı örnekleme
  • Bölüm başına N belge
  • opsiyonel

Bölümler çeşitli şemalara sahip olduğunda kullanın

TimePartitionedSampler

  • Min/max'i zaman gruplarına böler
  • Grup başına N belge
  • isteğe bağlı (varsayılan )

Şema zaman içinde geliştikçe kullanma

Uyarı

Birden çok sorgu nedeniyle daha yoğun kaynak kullanır.

--graphql

Şema dışarı aktarmayı etkinleştirir. Bu olmadan dışarı aktarma işlemi bir hata kaydeder ve şema dosyası oluşturmaz.

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-out

-o, --output

Şema dosyası için dizin. Eksikse oluşturulur.

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-out

-g, --graphql-schema-file

Yalnızca çıktı dosya adı, varsayılan olarak olur .

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./out \
  -g custom-schema.gql

--generate

  • false (varsayılan): Çalışma zamanını başlatma, iç gözlem şeması
  • true: NoSQL verileri için Azure Cosmos DB şema oluşturma

Önemli

--generate yalnızca NoSQL yapılandırması için Azure Cosmos DB ile desteklenir.

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-gen \
  --generate

-m, --sampling-mode

Seçenekler: , , Varsayılan:

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-gen \
  --generate \
  --sampling-mode TopNExtractor

-n, --sampling-count

  • TopNExtractor: toplam belge sayısı
  • EligibleDataSampler: bölüm başına
  • TimePartitionedSampler: zaman grubu başına

Varsayılanlar moda bağımlıdır:

  • :
  • :
  • :

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-gen \
  --generate \
  --sampling-mode TopNExtractor \
  --sampling-count 25

--sampling-partition-key-path

EligibleDataSampler için bölüm anahtarı yolu

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-partitions \
  --generate \
  --sampling-mode EligibleDataSampler \
  --sampling-partition-key-path /customerId

-d, --sampling-days

Belgeleri recency (gün) ölçütüne göre filtreleme

Varsayılanlar moda bağımlıdır:

  • : zaman sınırı yok (varsayılan )
  • :
  • :

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-gen \
  --generate \
  --sampling-days 14

--sampling-group-count

TimePartitionedSampler için zaman gruplarının sayısı

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-time \
  --generate \
  --sampling-mode TimePartitionedSampler \
  --sampling-group-count 8

-c, --config

Yapılandırma dosyası yolu. Atlanırsa:

  1. env var ayarlandıysa
  2. Yoksa

Example

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-out \
  --config ./dab-config.json

--help

Yardım ekranını görüntüleyin.

Example

  • Bash
  • Komut İstemi 
dab export --help

--version

Sürüm bilgilerini görüntüleme.

Example

  • Bash
  • Komut İstemi 
dab export --version

İade kodları

Kod Meaning
0 Dışarı aktarma başarılı oldu
-1 Dışarı aktarma başarısız oldu

Örnekler

Mevcut şemayı dışarı aktarma

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-out

Şema oluşturma (TopNExtractor)

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-gen \
  --generate \
  --sampling-mode TopNExtractor \
  --sampling-count 25 \
  --sampling-days 14

Bölüme duyarlı örnekleme

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-partitions \
  --generate \
  --sampling-mode EligibleDataSampler \
  --sampling-partition-key-path /customerId \
  --sampling-count 10

Zamana dayalı örnekleme

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./schema-time \
  --generate \
  --sampling-mode TimePartitionedSampler \
  --sampling-group-count 8 \
  --sampling-count 5 \
  --sampling-days 60

Özel çıkış dosya adı

  • Bash
  • Komut İstemi 
dab export \
  --graphql \
  -o ./out \
  -g cosmos-schema.gql \
  --generate \
  --sampling-mode TopNExtractor \
  --sampling-count 15

Oluşturulan dosya kullanımı

Dışarı aktarılan şema dosyası yoluna ayarlayın . Daha fazla bilgi için bkz. Veri kaynağı yapılandırması.

İpucu

Oluşturulan şemayı kararlı bir şekilde işleyin. Veri modeli değişirse yeniden çalıştırın.

Sorun giderme

Semptom Nedeni Düzelt
Boş şema Veri yok veya yetersiz Temsili veriler ekleme
Bağlantı hatası Hatalı bağlantı dizesi Kimlik bilgilerini veya ağı düzeltme
Eksik alanlar Örneklenen belgelerde yok Sayıyı veya değişiklik modunu artırma
Birkaç bölüm sonucu Yanlış bölüm anahtarı Doğru anahtar yolunu belirtin
Yavaş örnekleme Büyük veri kümesi Grupları veya günleri azaltma

En iyi yöntemler

  • TopNExtractor ile başlayın
  • Şema değişikliklerini fark etmek için sürüm denetimini kullanma
  • Kritik koleksiyonlar için farklı parametrelerle birden çok geçiş çalıştırın
  • Last updated on