volumes komut grubu

Note

Bu bilgiler Databricks CLI 0.205 ve üzeri sürümleri için geçerlidir. Databricks CLI Genel Önizleme aşamasındadır.

Databricks CLI kullanımı, Kullanım Verileri sağlamaları da dahil olmak üzere Databricks Lisansı ve Databricks Gizlilik Bildirimi'ne tabidir.

volumes Databricks CLI içindeki komut grubu Unity Kataloğu'nda birimleri yönetmeye yönelik komutlar içerir. Birimler dosyalara erişme, dosyaları depolama, yönetme, düzenleme ve işleme özellikleri sağlar. Bkz. Unity Catalog'un birimleri nelerdir?.

databricks birimleri oluşturma

Yeni bir birim oluşturun.

Kullanıcı bir dış birim veya yönetilen birim oluşturabilir. Belirtilen dış konumda bir dış birim oluşturulurken, yönetilen birim üst şema, üst katalog veya meta veri deposu tarafından belirtilen varsayılan konumda bulunur.

Birim oluşturma işleminin başarılı olması için kullanıcının aşağıdaki koşulları karşılaması gerekir:

• Çağıran kişi, bir metastore yöneticisi olmalı veya üst kataloğun ve şemanın sahibi olmalı ya da üst katalogda USE_CATALOG ayrıcalığı ve üst şemada USE_SCHEMA ayrıcalığı bulunmalıdır.
• Çağıranın üst şemada ayrıcalığı olmalıdır CREATE VOLUME .

Harici birim için aşağıdaki koşulların da karşılanması gerekir.

• Çağıranın dış konumda CREATE EXTERNAL VOLUME yetkisi olmalıdır.
• Belirtilen depolama konumunda başka tablo veya birim yok. - Belirtilen depolama konumu diğer tabloların, birimlerin, katalogların veya şemaların konumu altında değil.

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    Şemanın ve birimin bulunduğu kataloğun adı

SCHEMA_NAME

    Hacmin bulunduğu şemanın adı

NAME

    Birimin adı

VOLUME_TYPE

    Birimin türü. Harici birim belirtilen lokasyonda bulunur. Yönetilen birim, üst şema veya üst katalog ya da Meta veri deposu tarafından belirtilen varsayılan konumda bulunur. Bkz. Yönetilen ve dış birimler. Desteklenen değerler: EXTERNAL, MANAGED

Options

--comment string

    Hacme iliştirilen açıklama.

--json JSON

    satır içi JSON dizesi veya @path istek gövdesine sahip JSON dosyasına.

--storage-location string

    Bulut üzerindeki depolama konumu.

Genel bayraklar

Examples

Aşağıdaki örnek yönetilen birim oluşturur:

databricks volumes create my_catalog my_schema my_volume MANAGED

Aşağıdaki örnek, açıklama içeren bir harici birim oluşturur.

databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"

databricks birimleri sil

Belirtilen üst katalogdan ve şemadan bir birimi silin.

Çağıranın bir meta veri deposu yöneticisi veya birimin sahibi olması gerekir. İkinci durumda, çağıranın da sahibi olması veya üst katalogda USE_CATALOG ayrıcalığına ve üst şemada USE_SCHEMA ayrıcalığına sahip olması gerekir.

databricks volumes delete NAME [flags]

Arguments

NAME

    Hacmin üç düzeyli (tam nitelikli) adı

Options

Genel bayraklar

Examples

Aşağıdaki örnek bir hacmi siler:

databricks volumes delete my_catalog.my_schema.my_volume

databricks birimleri listesi

Geçerli metastore'daki birimleri ana katalog ve şema altında listeleyin.

Geri döndürülen birimler, çağrı yapan kullanıcının ayrıcalıklarına göre filtrelenir. Örneğin, meta veri deposu yöneticisi tüm birimleri listeleyebiliyor. Yanıttaki birimleri alabilmek için normal bir kullanıcının birimin sahibi olması veya birim üzerinde READ VOLUME ayrıcalığına sahip olması gerekir. İkinci durumda, çağıranın da sahibi olması veya üst katalogda USE_CATALOG ayrıcalığına ve üst şemada USE_SCHEMA ayrıcalığına sahip olması gerekir.

Dizideki öğelerin belirli bir sıralama garantisi yoktur.

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Kataloğun tanımlayıcısı

SCHEMA_NAME

    Şemanın tanımlayıcısı

Options

--include-browse

    Yetkilinin yalnızca sınırlı meta verilere erişebileceği hacimlerin yanıta dahil edilip edilmeyeceği.

--max-results int

    Döndürülecek maksimum hacim sayısı (sayfa uzunluğu).

--page-token string

    Önceki bir istek tarafından döndürülen opak belirteç.

Genel bayraklar

Examples

Aşağıdaki örnekte bir katalogdaki ve şemadaki tüm birimler listelenmiştir:

databricks volumes list my_catalog my_schema

databricks birimleri okundu

Belirli bir katalog ve şema için meta veri deposundan birim alma.

Arayan kişi, bir metastore yöneticisi veya birimin sahibi olmalı ya da birim üzerinde READ VOLUME ayrıcalığına sahip olmalıdır. İkinci durumda, çağıranın da sahibi olması veya üst katalogda USE_CATALOG ayrıcalığına ve üst şemada USE_SCHEMA ayrıcalığına sahip olması gerekir.

databricks volumes read NAME [flags]

Arguments

NAME

    Hacmin üç düzeyli (tam nitelikli) adı

Options

--include-browse

    Yetkilinin yalnızca sınırlı meta verilere erişebileceği hacimlerin yanıta dahil edilip edilmeyeceği.

Genel bayraklar

Examples

Aşağıdaki örnek bir birim hakkında bilgi sağlar.

databricks volumes read my_catalog.my_schema.my_volume

Aşağıdaki örnek, göz atma meta verileri de dahil olmak üzere birim bilgilerini alır.

databricks volumes read my_catalog.my_schema.my_volume --include-browse

databricks birimleri güncelleştirmesi

Belirtilen ana katalog ve şema altında belirtilen hacmi güncelle.

Çağıranın bir meta veri deposu yöneticisi veya birimin sahibi olması gerekir. İkinci durumda, çağıranın da sahibi olması veya üst katalogda USE_CATALOG ayrıcalığına ve üst şemada USE_SCHEMA ayrıcalığına sahip olması gerekir.

Şu anda yalnızca birim adı, sahibi veya disk biriminin açıklaması güncellenebilir.

databricks volumes update NAME [flags]

Arguments

NAME

    Hacmin üç düzeyli (tam nitelikli) adı

Options

--comment string

    Hacme iliştirilen açıklama.

--json JSON

    satır içi JSON dizesi veya @path istek gövdesine sahip JSON dosyasına.

--new-name string

    Birimin yeni adı.

--owner string

    Hacmin sahibi olan kullanıcının tanımlayıcısı.

Genel bayraklar

Examples

Aşağıdaki örnek bir birimin açıklamasını güncelleştirir:

databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"

Aşağıdaki örnek bir birimin sahibini değiştirir:

databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com

Aşağıdaki örnek bir birimi yeniden adlandırır:

databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name

Genel bayraklar

--debug

  Hata ayıklama günlüğünün etkinleştirilip etkinleştirilmeyileceği.

-h veya --help

    Databricks CLI veya ilgili komut grubu ya da ilgili komut için yardım görüntüleyin.

--log-file dizgi

    Yazılım günlüklerini yazmak için kullanılacak dosyayı temsil eden bir metin. Bu bayrak belirtilmezse varsayılan değer, çıkış günlüklerini stderr'a yazmaktır.

--log-format biçim

    Günlük biçimi türü, text veya json. Varsayılan değer şudur: text.

--log-level dizgi

    Günlük format düzeyini temsil eden bir karakter dizisi. Belirtilmezse günlük format seviyesi devre dışı bırakılır.

-o, --output tür

    Komut çıktı türü text veya json. Varsayılan değer şudur: text.

-p, --profile dizgi

    Komutu çalıştırmak için kullanılacak dosyadaki ~/.databrickscfg profilin adı. Bu bayrak belirtilmezse ve varsa, DEFAULT adlı profil kullanılır.

--progress-format biçim

    İlerleme günlüklerini görüntüleme biçimi: default, append, inplaceveya json

-t, --target dizgi

    Varsa, kullanılacak paket hedefi