shares 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.

shares Databricks CLI içindeki komut grubu, Unity Kataloğu'ndaki paylaşımları yönetmenize olanak tanır.

Bir pay, shares create ile örneklenmiş bir kapsayıcıdır. Oluşturulduktan sonra kullanarak shares updatemeta veri deposu içinde tanımlanan mevcut veri varlıklarından oluşan bir koleksiyonu yinelemeli olarak kaydedebilirsiniz. Veri varlıklarını özgün adları altında kaydedebilir, özgün şemalarına göre niteleyebilir veya diğer kullanıma sunulan adlar sağlayabilirsiniz.

databricks hisseleri oluşturma

Veri nesneleri için yeni bir paylaşım oluşturun. Veri nesneleri oluşturulduktan sonra update ile eklenebilir. Çağıranın bir meta veri deposu yöneticisi olması veya meta veri deposunda ayrıcalığına sahip CREATE_SHARE olması gerekir.

databricks shares create NAME [flags]

Arguments

NAME

    Paylaşımın adı.

Options

--comment string

    Kullanıcı tarafından sağlanan serbest biçimli metin açıklaması.

--json JSON

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

--storage-root string

    Paylaşımdaki not defteri dosyaları için depolama kök URL'si.

Genel bayraklar

Examples

Aşağıdaki örneklerde, açıklamayla adlı my-analytics-share bir paylaşım oluşturulur:

databricks shares create my-analytics-share --comment "Sales analytics data share"

Aşağıdaki örnek, belirli bir depolama köküyle bir paylaşım oluşturur:

databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"

databricks paylaşımlarını silme

Meta veri deposundan bir paylaşımı silin. Arayan, paylaşımın sahibi olmalıdır.

databricks shares delete NAME [flags]

Arguments

NAME

    Paylaşımın adı.

Options

Genel bayraklar

Examples

Aşağıdaki örnek adlı my-analytics-sharebir paylaşımı siler:

databricks shares delete my-analytics-share

databricks hisse senetleri aliniyor

Meta veri deposundan bir paylaşım alın. Arayanın bir meta veri deposu yöneticisi veya paylaşımın sahibi olması gerekir.

databricks shares get NAME [flags]

Arguments

NAME

    Paylaşımın adı.

Options

--include-shared-data

    Paylaşıma eklenecek verileri sorgula.

Genel bayraklar

Examples

Aşağıdaki örnek, adlı my-analytics-share bir paylaşım hakkında bilgi alır:

databricks shares get my-analytics-share

Aşağıdaki örnek, paylaşılan verilerle ilgili ayrıntıları içeren bir paylaşım alır:

databricks shares get my-analytics-share --include-shared-data

databricks paylaşımları listesi (Kullanım dışı)

Deprecated. Meta veri deposundaki paylaşımları listeleyin. Arayanın bir meta veri deposu yöneticisi veya paylaşımın sahibi olması gerekir. Dizideki öğelerin sırası garanti değildir.

databricks shares list [flags]

Arguments

None

Options

--max-results int

    Döndürülecek en fazla hisse sayısı.

--page-token string

    Önceki sorguya göre sonraki sayfaya gitmek için opak sayfalama belirteci.

Genel bayraklar

databricks hisse listesini görüntüle

Meta veri deposundaki paylaşımları listeleyin. Arayanın bir meta veri deposu yöneticisi veya paylaşımın sahibi olması gerekir. Dizideki öğelerin sırası garanti değildir.

databricks shares list-shares [flags]

Arguments

None

Options

--max-results int

    Döndürülecek en fazla hisse sayısı.

--page-token string

    Önceki sorguya göre sonraki sayfaya gitmek için opak sayfalama belirteci.

Genel bayraklar

Examples

Aşağıdaki örnek tüm paylaşımları listeler:

databricks shares list-shares

databricks hisseleri güncellemesi

Paylaşımı istekteki değişiklikler ve veri nesneleriyle güncelleştirin. Arayan, paylaşımın sahibi veya meta veri deposu yöneticisi olmalıdır.

Çağıran bir meta veri deposu yöneticisi olduğunda, yalnızca owner alan güncelleştirilebilir.

Paylaşım adının değiştirilmesi durumunda, updateShare çağıranın paylaşımın sahibi olması ve CREATE_SHARE ayrıcalığına sahip olması gerekir.

Paylaşımda not defteri dosyaları varsa, storage_root alan güncelleştirilemez.

Bu yöntem aracılığıyla eklenen her tablo için, paylaşım sahibinin de SELECT tabloda ayrıcalığı olmalıdır. Alıcıların tabloya erişebilmesi için bu ayrıcalık süresiz olarak korunmalıdır. Genellikle, paylaşım sahibi olarak bir grup kullanmanız gerekir.

Tablo kaldırmaları update aracılığıyla ek ayrıcalıklar gerektirmez.

databricks shares update NAME [flags]

Arguments

NAME

    Paylaşımın adı.

Options

--comment string

    Kullanıcı tarafından sağlanan serbest biçimli metin açıklaması.

--json JSON

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

--new-name string

    Paylaşım için yeni ad.

--owner string

    Geçerli paylaşım sahibinin kullanıcı adı.

--storage-root string

    Paylaşımdaki not defteri dosyaları için depolama kök URL'si.

Genel bayraklar

Examples

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

databricks shares update my-analytics-share --comment "Updated sales analytics data share"

Aşağıdaki örnek bir paylaşımın adını değiştirir:

databricks shares update my-analytics-share --new-name "sales-analytics-share"

Aşağıdaki örnek bir paylaşımın sahibini güncelleştirir:

databricks shares update my-analytics-share --owner "someone@example.com"

Aşağıdaki örnek JSON yapılandırmasını kullanarak bir paylaşımı güncelleştirir:

databricks shares update my-analytics-share --json '{
  "comment": "Updated share with new tables",
  "objects": [
    {
      "name": "sales.customers",
      "data_object_type": "TABLE"
    }
  ]
}'

databricks paylaşım izinleri

Meta veri deposundan veri paylaşımı için izinler alın. Arayanın bir meta veri deposu yöneticisi veya paylaşımın sahibi olması gerekir.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    Paylaşımın adı.

Options

--max-results int

    Döndürülecek izin sayısı üst sınırı.

--page-token string

    Önceki sorguya göre sonraki sayfaya gitmek için opak sayfalama belirteci.

Genel bayraklar

Examples

Aşağıdaki örnek my-analytics-share adlı bir paylaşım için izinleri alır:

databricks shares share-permissions my-analytics-share

databricks, güncelleştirme izinlerini paylaşır

Meta veri deposundaki bir veri paylaşımının izinlerini güncelleştirin. Arayan bir meta veri deposu yöneticisi veya paylaşımın sahibi olmalıdır.

Yeni alıcı izinleri için kullanıcının da alıcı sahibi veya meta veri deposu yöneticisi olması gerekir. Alıcı iptalleri ek ayrıcalık gerektirmez.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    Paylaşımın adı.

Options

--json JSON

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

--omit-permissions-list

    Optional.

Genel bayraklar

Examples

Aşağıdaki örnek, bir alıcıya erişim izinleri tanımlar:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "add": ["SELECT"]
    }
  ]
}'

Aşağıdaki örnek, bir alıcıdan gelen izinleri iptal eder:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "remove": ["SELECT"]
    }
  ]
}'

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