external-locations 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.

external-locations Databricks CLI içindeki komut grubu, Unity Kataloğu'nun dış konumlarını oluşturmaya ve yönetmeye yönelik komutları içerir. Bkz. Unity Catalog'un birimleri nelerdir?.

databricks dış konumları oluşturma

Meta veri deposunda yeni bir dış konum girişi oluşturun. Çağıranın bir meta veri deposu yöneticisi olması veya hem meta veri deposu hem de ilişkili depolama kimlik bilgileri üzerinde ayrıcalığına sahip CREATE_EXTERNAL_LOCATION olması gerekir.

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Dış konumun adı.

URL

    Dış konumun yol URL'si.

CREDENTIAL_NAME

    Bu konumla kullanılan depolama kimlik bilgilerinin adı.

Options

--comment string

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

--enable-file-events

    Bu dış konumda dosya olaylarının etkinleştirilip etkinleştirilmeyileceği.

--fallback

    Bu dış konum için geri dönüş modunun etkinleştirilip etkinleştirilmediğini gösterir.

--json JSON

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

--read-only

    Dış konumun salt okunur bir durumda olup olmadığını belirtir.

--skip-validation

    Dış konumla ilişkili depolama kimlik bilgilerinin doğrulanması atlar.

Genel bayraklar

Examples

Aşağıdaki örnek, açıklama içeren bir dış konum oluşturur:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"

Aşağıdaki örnek salt okunur bir dış konum oluşturur:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only

databricks harici konumları sil

Belirtilen dış konumu meta veri deposundan silin. Arayan, dış konumun sahibi olmalıdır.

databricks external-locations delete NAME [flags]

Arguments

NAME

    Dış konumun adı.

Options

--force

    Bağımlı dış tablolar veya montajlar olsa bile silmeyi zorla.

Genel bayraklar

Examples

Aşağıdaki örnek adlı my-external-locationbir dış konumu siler:

databricks external-locations delete my-external-location

Aşağıdaki örnek, bağımlılıklar olsa bile bir dış konumu zorla siler:

databricks external-locations delete my-external-location --force

databricks dış konumları alma

Meta veri deposundan bir harici konum alın. Arayan bir meta veri deposu yöneticisi, dış konumun sahibi veya dış konumda bazı ayrıcalıklara sahip bir kullanıcı olmalıdır.

databricks external-locations get NAME [flags]

Arguments

NAME

    Dış konumun adı.

Options

--include-browse

    Yetkilinin yalnızca seçmeli meta verilere erişebildiği yanıta harici konumların dahil edilip edilmeyeceği.

Genel bayraklar

Examples

Aşağıdaki örnek, my-external-location adlı dış konum hakkında bilgi alır:

databricks external-locations get my-external-location

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

databricks external-locations get my-external-location --include-browse

databricks harici konumları listele

Meta veri deposundaki dış konumları listeleyin. Arayan bir meta veri deposu yöneticisi, dış konumun sahibi veya dış konumda bazı ayrıcalıklara sahip bir kullanıcı olmalıdır. Dizideki öğelerin belirli bir sıralama garantisi yoktur.

databricks external-locations list [flags]

Options

--include-browse

    Yetkilinin yalnızca seçmeli meta verilere erişebildiği yanıta harici konumların dahil edilip edilmeyeceği.

--include-unbound

    Çalışma alanına bağlı olmayan dış konumların dahil edilip edilmeyeceği.

--max-results int

    Döndürülecek en fazla dış konum sayısı.

--page-token string

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

Genel bayraklar

Examples

Aşağıdaki örnekte tüm dış konumlar listelenir:

databricks external-locations list

Aşağıdaki örnekte en fazla 10 sonuç içeren dış konumlar listelenir:

databricks external-locations list --max-results 10

databricks dış konum güncelleştirmesi

Meta veri deposundaki bir dış konumu güncelleştirin. Arayanın dış konumun sahibi veya meta veri deposu yöneticisi olması gerekir. İkinci durumda yönetici yalnızca dış konumun adını güncelleştirebilir.

databricks external-locations update NAME [flags]

Arguments

NAME

    Dış konumun adı.

Options

--comment string

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

--credential-name string

    Bu konumla kullanılan depolama kimlik bilgilerinin adı.

--enable-file-events

    Bu dış konumda dosya olaylarının etkinleştirilip etkinleştirilmeyileceği.

--fallback

    Bu dış konum için geri dönüş modunun etkinleştirilip etkinleştirilmediğini gösterir.

--force

    Güncelleştirmeyi zorlayın, URL'nin değiştirilmesi bağımlı dış tabloları veya monte edilmiş birimleri geçersiz kılsa bile.

--isolation-mode IsolationMode

    Desteklenen değerler: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--json JSON

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

--new-name string

    Dış konum için yeni ad.

--owner string

    Dış konumun sahibi.

--read-only

    Dış konumun salt okunur bir durumda olup olmadığını belirtir.

--skip-validation

    Dış konumla ilişkili depolama kimlik bilgilerinin doğrulanması atlar.

--url string

    Dış konumun yol URL'si.

Genel bayraklar

Examples

Aşağıdaki örnek dış konumu yeniden adlandırır:

databricks external-locations update my-external-location --new-name my-renamed-location

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

databricks external-locations update my-external-location --owner someone@example.com

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

    Çıkış günlüklerinin yazılması için dosyayı temsil eden bir dize. 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ü veya textjson. 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, varsa adlı DEFAULT 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