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

apps Databricks CLI içindeki komut grubu uygulamaları yönetmenize olanak tanır. Uygulamalar doğrudan müşterinin Databricks örneğinde çalışır, verileriyle tümleştirilir, Databricks hizmetlerini kullanır ve genişletir ve kullanıcıların çoklu oturum açma aracılığıyla etkileşim kurmasına olanak tanır. Bkz. Databricks Uygulamaları.

databricks uygulamaları oluşturma

Yeni uygulama oluşturma.

databricks apps create NAME [flags]

Arguments

NAME

    Uygulamanın adı. Ad yalnızca küçük harfli alfasayısal karakterler ve kısa çizgiler içermelidir. Çalışma alanı içinde benzersiz olmalıdır.

Options

--budget-policy-id string

    Uygulamanın bütçe politikası ID'si.

--compute-size ComputeSize

    Uygulamanın işlem boyutu. Desteklenen değerler: LARGE, MEDIUM.

--description string

    Uygulamanın açıklaması.

--json JSON

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

--no-compute

    Eğer doğruysa, uygulama oluşturulduktan sonra başlatılmaz.

--no-wait

    AKTİF duruma ulaşmak için beklemeyin.

--space string

    Bu uygulamanın ait olduğu alanın adı.

--timeout duration

    AKTİF duruma ulaşmak için en fazla süre (varsayılan 20 dakika 0 saniye).

--usage-policy-id string

    Uygulamanın kullanım ilkesi kimliği.

Genel bayraklar

Examples

Aşağıdaki örnek temel bir uygulama oluşturur:

databricks apps create my-analytics-app --description "Analytics dashboard app"

Aşağıdaki örnek, başlatmadan bir uygulama oluşturur:

databricks apps create my-data-app --description "Data processing app" --no-compute

Aşağıdaki örnek, özel zaman aşımına sahip bir uygulama oluşturur:

databricks apps create my-ml-app --description "Machine learning app" --timeout 30m

databricks uygulamaları oluşturma-güncelleştirme

Bir uygulama güncelleştirmesi oluşturur ve güncelleştirme işlemini başlatır. Güncelleştirme işlemi zaman uyumsuzdur ve güncelleştirmenin durumu GetAppUpdate yöntemiyle denetlenebilir.

databricks apps create-update APP_NAME UPDATE_MASK [flags]

Arguments

APP_NAME

    Uygulamanın adı.

UPDATE_MASK

    Alan maskesi, birden çok alanı virgülle ayrılmış (boşluksuz) tek bir dize olmalıdır. Alan yolu, alt alanlarda (örneğin, author.given_name) gezinmek için nokta (.) kullanarak kaynak nesnesine göredir. Yalnızca koleksiyon alanının tamamı belirtilebileceği için, sıra veya eşleme alanlarındaki öğelerin belirtimine izin verilmez. Alan adları kaynak alanı adlarla tam olarak eşleşmelidir.

    * alan maskesi tam değişimi gösterir. Gelecekte API değişirse istenmeyen sonuçlara neden olabileceğinden, güncelleştirilmekte olan alanları her zaman açıkça listelemek ve * joker karakter kullanmaktan kaçınmanızı öneririz.

Options

--json JSON

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

--no-wait

    BAŞARILI duruma ulaşmak için beklemeyin.

--timeout duration

    BAŞARILI durumuna (varsayılan 20m0s) ulaşmak için gereken en fazla süre.

Genel bayraklar

Examples

Aşağıdaki örnek, belirli bir alan maskesiyle bir uygulama güncelleştirmesi oluşturur:

databricks apps create-update my-analytics-app "description" --json '{"description": "Updated app description"}'

Aşağıdaki örnek, tamamlanmasını beklemeden bir uygulama güncelleştirmesi oluşturur:

databricks apps create-update my-data-app "budget_policy_id" --json '{"budget_policy_id": "new-policy-123"}' --no-wait

Aşağıdaki örnek, özel bir zaman aşımı ile bir uygulama güncelleştirmesi oluşturur:

databricks apps create-update my-ml-app "description,budget_policy_id" --json '{"description": "Updated ML app", "budget_policy_id": "ml-policy-456"}' --timeout 30m

databricks uygulamaları silme

Bir uygulamayı silin.

Bağımsız değişken olmadan NAME bir Databricks Apps proje dizininden (içerendatabricks.yml) çalıştırıldığında, bu komut proje tarafından dağıtılan tüm kaynakları yok eder. Bir NAME bağımsız değişken sağlandığında veya proje dizininde olmadığında, api'yi kullanarak belirtilen uygulamayı doğrudan siler.

databricks apps delete [NAME] [flags]

Arguments

NAME

    Uygulamanın adı. Proje dizininde olmadığında gereklidir. Proje dizininde sağlandığında, proje yok etmek yerine API silmeyi kullanır.

Options

--auto-approve

    Kaynakları ve dosyaları silmek için etkileşimli onayları atlayın.

--force-lock

    Dağıtım kilidinin alımını zorla.

Genel bayraklar

Examples

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

databricks apps delete my-analytics-app

Aşağıdaki örnek, bir proje dizinindeki tüm proje kaynaklarını yok eder:

databricks apps delete

Aşağıdaki örnek, otomatik onay ile proje kaynaklarını yok eder:

databricks apps delete --auto-approve

databricks uygulamaları dağıtmak

Uygulama dağıtımı oluşturma.

Bağımsız değişken olmadan APP_NAME bir Databricks Apps proje dizininden (içerendatabricks.yml) çalıştırıldığında, bu komut projeyi doğrulayan, çalışma alanına dağıtan ve uygulamayı çalıştıran gelişmiş bir dağıtım işlem hattı çalıştırır. Bir APP_NAME bağımsız değişken sağlandığında veya proje dizininde olmadığında, api'yi kullanarak doğrudan bir uygulama dağıtımı oluşturur.

databricks apps deploy [APP_NAME] [flags]

Arguments

APP_NAME

    Uygulamanın adı. Proje dizininde olmadığında gereklidir. Proje dizininde sağlandığında, proje dağıtımı yerine API dağıtımı kullanılır.

Options

--deployment-id string

    Dağıtımın benzersiz kimliği.

--force

    Git dal doğrulamayı zorla geçersiz kıl.

--json JSON

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

--mode AppDeploymentMode

    Kaynak kodunun yönetileceği dağıtım modu. Desteklenen değerler: AUTO_SYNC, SNAPSHOT.

--no-wait

    BAŞARILI duruma ulaşmak için beklemeyin.

--skip-tests

    Doğrulama sırasında testleri çalıştırmayı atlayın (varsayılan true).

--skip-validation

    Proje doğrulamayı atlayın (derleme, tür denetimi, lint).

--source-code-path string

    Uygulama dağıtımını oluşturmak için kullanılan kaynak kodun çalışma alanı dosya sistemi yolu.

--timeout duration

    BAŞARILI durumuna (varsayılan 20m0s) ulaşmak için gereken en fazla süre.

Genel bayraklar

Examples

Aşağıdaki örnek, otomatik eşitleme moduyla bir dağıtım oluşturur:

databricks apps deploy my-analytics-app --source-code-path /Workspace/Users/someone@example.com/my-app --mode AUTO_SYNC

Aşağıdaki örnek, anlık görüntü moduyla bir dağıtım oluşturur:

databricks apps deploy my-data-app --source-code-path /Workspace/Users/someone@example.com/data-app --mode SNAPSHOT

Aşağıdaki örnek, özel dağıtım kimliğine sahip bir dağıtım oluşturur:

databricks apps deploy my-ml-app --deployment-id "v1.2.3" --source-code-path /Workspace/Users/someone@example.com/ml-app

databricks uygulamalarını al

Verilen adla uygulamanın bilgilerini alın.

databricks apps get NAME [flags]

Arguments

NAME

    Uygulamanın adı.

Options

Genel bayraklar

Examples

Aşağıdaki örnek uygulama bilgilerini alır:

databricks apps get my-analytics-app

Aşağıdaki örnek, uygulama bilgilerini JSON biçiminde alır:

databricks apps get my-data-app --output json

Aşağıdaki örnek belirli bir profili kullanarak uygulama bilgilerini alır:

databricks apps get my-ml-app --profile production

databricks uygulamaları get-deployment

Sağlanan ad ve dağıtım kimliğiyle uygulama dağıtımıyla ilgili bilgileri alın.

databricks apps get-deployment APP_NAME DEPLOYMENT_ID [flags]

Arguments

APP_NAME

    Uygulamanın adı.

DEPLOYMENT_ID

    Dağıtımın benzersiz kimliği.

Options

Genel bayraklar

Examples

Aşağıdaki örnek dağıtım bilgilerini alır:

databricks apps get-deployment my-analytics-app v1.0.0

Aşağıdaki örnek, dağıtım bilgilerini JSON biçiminde alır:

databricks apps get-deployment my-data-app v2.1.0 --output json

Aşağıdaki örnek, belirli bir profili kullanarak dağıtım bilgilerini alır:

databricks apps get-deployment my-ml-app latest --profile production

databricks uygulamaları get-update

Uygulama güncelleştirmesinin durumunu alma.

databricks apps get-update APP_NAME [flags]

Arguments

APP_NAME

    Uygulamanın adı.

Options

Genel bayraklar

Examples

Aşağıdaki örnek bir uygulama güncelleştirmesinin durumunu alır:

databricks apps get-update my-analytics-app

Aşağıdaki örnek JSON biçiminde güncelleştirme durumunu alır:

databricks apps get-update my-data-app --output json

Aşağıdaki örnek, belirli bir profili kullanarak güncelleştirme durumunu alır:

databricks apps get-update my-ml-app --profile production

databricks uygulamalarını içeri aktarma

(Deneysel) Mevcut bir Databricks uygulamasını paket olarak içeri aktar.

Mevcut bir Databricks uygulamasını içeri aktarıp bir paket yapılandırmasına dönüştürün. Bu komut, uygulama yapılandırmasıyla yeni bir paket dizini oluşturur, uygulama kaynak kodunu indirir, paketi mevcut uygulamaya bağlar ve doğrudan dağıtım modunu kullanarak dağıtır.

databricks apps import [flags]

Arguments

None

Options

--cleanup

    Önceki uygulama klasörünü ve tüm içeriğini temizleyin.

--force-import

    Zaten içeri aktarılmış bir uygulamayı yeniden içeri aktarmaya zorlama (yalnızca sahip olduğunuz uygulamalarda çalışır).

--name string

    İçeri aktaracak uygulamanın adı. Belirtilmezse, etkileşimli seçim için tüm uygulamaları listeler.

--output-dir string

    Paketin çıkışını almak için dizin. Varsayılan olarak uygulama adını kullanır.

-q, --quiet

    Bilgilendiren iletileri gizleme (yalnızca hataları ve istemleri gösterir).

Genel bayraklar

Examples

Aşağıdaki örnek, uygulamanın adını taşıyan bir dizin oluşturarak bir uygulamayı içeri aktarır:

databricks apps import --name my-streamlit-app

Aşağıdaki örnek, özel çıkış dizinine sahip bir uygulamayı içeri aktarır:

databricks apps import --name my-app --output-dir ~/my-apps/analytics

Aşağıdaki örnek bir uygulamayı içeri aktarır ve eski uygulama klasörünü temizler:

databricks apps import --name my-app --cleanup

databricks uygulamaları listesi

Çalışma alanı içindeki tüm uygulamaları listeleyin.

databricks apps list [flags]

Arguments

None

Options

--page-size int

    Döndürülen öğeler için üst sınır.

--page-token string

    Uygulamaların sonraki sayfasına gitmek için sayfalandırma belirteci.

--space string

    Uygulamaları uygulama alanı adına göre filtreleyin.

Genel bayraklar

Examples

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

databricks apps list

Aşağıdaki örnekte belirli bir sayfa boyutuna sahip uygulamalar listelenir:

databricks apps list --page-size 10

Aşağıdaki örnekte sayfalandırılmış uygulamalar listelenir:

databricks apps list --page-token "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

databricks apps list-deployments

Uygulamanın tüm uygulama dağıtımlarını sağlanan adla listeleyin.

databricks apps list-deployments APP_NAME [flags]

Arguments

APP_NAME

    Uygulamanın adı.

Options

--page-size int

    Döndürülen öğeler için üst sınır.

--page-token string

    Uygulamaların sonraki sayfasına gitmek için sayfalandırma belirteci.

Genel bayraklar

Examples

Aşağıdaki örnekte bir uygulama için tüm dağıtımlar listelenir:

databricks apps list-deployments my-analytics-app

Aşağıdaki örnek, belirli bir sayfa boyutuna sahip dağıtımları listeler:

databricks apps list-deployments my-data-app --page-size 10

databricks uygulama günlükleri

Bir Databricks uygulaması için günlük akışını kullanarak stdout/stderr günlüklerini akışa alın. Varsayılan olarak, bu komut en son günlükleri getirir --tail-lines ve son verir. Sunucu tarafı filtrelemesi kullanılarak --search kullanılabilir ve istemci tarafı filtrelemesi kullanılarak --source APP|SYSTEMkullanılabilir.

databricks apps logs [NAME] [flags]

Arguments

NAME

    Uygulamanın adı.

Options

-f, --follow

    Belirtilen zaman aşımına ulaşılana veya iptal edilene kadar log akışını sürdürün.

--tail-lines int

    Akış öncesinde gösterilecek son günlük satırlarının sayısı. Her şeyi göstermek için 0 olarak ayarlayın. Varsayılan: 200

--timeout duration

     --follow ayarlandığında maksimum akış süresi. Zaman aşımını devre dışı bırakmak için 0 olarak ayarlayın.

--search string

    Akış öncesinde kayıt hizmetine bir arama terimi gönderin.

--source strings

    Günlükleri APP veya SYSTEM kaynaklarıyla sınırlayın.

--output-file string

    stdout'a ek olarak günlükleri yazmak için isteğe bağlı dosya yolu.

Genel bayraklar

Examples

Aşağıdaki örnek, bir uygulama için en son günlükleri getirir:

databricks apps logs my-analytics-app

Aşağıdaki örnek, kesintiye uğrayana kadar günlükleri sürekli olarak akışla kaydeder:

databricks apps logs my-analytics-app --follow

Aşağıdaki örnek, son 500 kayıt satırını getirir:

databricks apps logs my-data-app --tail-lines 500

Aşağıdaki örnek, 10 dakikalık zaman aşımına sahip günlükleri akışla aktarıyor:

databricks apps logs my-ml-app --follow --timeout 10m

Aşağıdaki örnek, günlükleri bir arama terimine göre filtreler:

databricks apps logs my-analytics-app --search "error"

Aşağıdaki örnek, günlükleri yalnızca uygulama düzeyinde çıktı ile sınırlar:

databricks apps logs my-data-app --source APP

Aşağıdaki örnek, günlükleri hem stdout'a hem de bir dosyaya yazar:

databricks apps logs my-ml-app --output-file /tmp/app-logs.txt

databricks uygulamaları yerel çalıştır

Uygulamayı yerel olarak başlatın.

databricks apps run-local [flags]

Arguments

None

Options

--app-port int

    Uygulamanın çalıştırıldığı bağlantı noktası (varsayılan 8000).

--debug

    Hata ayıklama modunu etkinleştirin.

--debug-port string

    Hata ayıklayıcının çalıştırıldığı bağlantı noktası.

--entry-point string

    Uygulama için yapılandırma (.yml dosyası) ile özel giriş noktasını belirtin. Varsayılan olarak app.yml değerini alır.

--env strings

    Ortam değişkenlerini ayarlayın.

--port int

    Uygulama ara sunucusunun çalıştırıldığı bağlantı noktası (varsayılan 8001).

--prepare-environment

    Uygulamayı çalıştırmak için ortamı hazırlar. Uv'nin yüklenmesini gerektirir.

Genel bayraklar

Examples

Aşağıdaki örnek, varsayılan ayarlarla yerel olarak bir uygulama çalıştırır:

databricks apps run-local

Aşağıdaki örnek, uygulamayı belirli bir bağlantı noktasında yerel olarak çalıştırır:

databricks apps run-local --app-port 9000 --port 9001

databricks uygulamalarını çalıştır

Çalışma alanında uygulamanın son etkin dağıtımını başlatın.

databricks apps start [NAME] [flags]

Arguments

NAME

    Uygulamanın adı.

Options

--no-wait

    AKTİF duruma ulaşmak için beklemeyin.

--timeout duration

    AKTİF duruma ulaşmak için en fazla süre (varsayılan 20 dakika 0 saniye).

Genel bayraklar

Examples

Aşağıdaki örnek bir uygulama başlatır:

databricks apps start my-analytics-app

Aşağıdaki örnek, beklemeden bir uygulama başlatır:

databricks apps start my-data-app --no-wait

Aşağıdaki örnek, özel zaman aşımı olan bir uygulamayı başlatır:

databricks apps start my-ml-app --timeout 30m

databricks uygulamaları durduruluyor

Çalışma alanında uygulamanın etkin dağıtımını durdurun.

databricks apps stop [NAME] [flags]

Arguments

NAME

    Uygulamanın adı.

Options

--no-wait

    DURMUŞ durumuna ulaşmak için beklemeyin.

--timeout duration

    DURDURULDU durumuna ulaşmak için en fazla süre (varsayılan 20m0s).

Genel bayraklar

Examples

Aşağıdaki örnek bir uygulamayı durdurur:

databricks apps stop my-analytics-app

Aşağıdaki örnek, beklemeden bir uygulamayı durdurur:

databricks apps stop my-data-app --no-wait

Aşağıdaki örnek, özel zaman aşımı olan bir uygulamayı durdurur:

databricks apps stop my-ml-app --timeout 30m

Databricks uygulamalarını güncelle

Uygulamayı sağlanan adla güncelleştirin.

databricks apps update NAME [flags]

Arguments

NAME

    Uygulamanın adı. Ad yalnızca küçük harfli alfasayısal karakterler ve kısa çizgiler içermelidir. Çalışma alanı içinde benzersiz olmalıdır.

Options

--budget-policy-id string

    Uygulamanın bütçe politikası ID'si.

--compute-size ComputeSize

    Uygulamanın işlem boyutu. Desteklenen değerler: LARGE, MEDIUM.

--description string

    Uygulamanın açıklaması.

--json JSON

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

--space string

    Bu uygulamanın ait olduğu alanın adı.

--usage-policy-id string

    Uygulamanın kullanım ilkesi kimliği.

Genel bayraklar

Examples

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

databricks apps update my-analytics-app --description "Updated analytics dashboard"

databricks uygulamaları izin-düzeylerini-getir

Uygulama izin düzeylerini alma.

databricks apps get-permission-levels APP_NAME [flags]

Arguments

APP_NAME

    İzinlerin alındığı veya yönetildiği uygulama.

Options

Genel bayraklar

Examples

Aşağıdaki örnek bir uygulama için izin düzeylerini alır:

databricks apps get-permission-levels my-analytics-app

databricks uygulamaları izinleri-al

Bir uygulamanın izinlerini alma. Uygulamalar izinleri kök nesnelerinden devralabilir.

databricks apps get-permissions APP_NAME [flags]

Arguments

APP_NAME

    İzinlerin alındığı veya yönetildiği uygulama.

Options

Genel bayraklar

Examples

Aşağıdaki örnek bir uygulama için izinleri alır:

databricks apps get-permissions my-analytics-app

Aşağıdaki örnek belirli bir profili kullanarak izinleri alır:

databricks apps get-permissions my-ml-app --profile production

databricks uygulamaları izinleri ayarla

Uygulama izinlerini ayarlayın.

Bir nesne üzerindeki izinleri ayarlar ve varsa var olan izinleri değiştirir. Belirtilmezse tüm doğrudan izinleri siler. Nesneler izinleri kök nesnelerinden devralabilir.

databricks apps set-permissions APP_NAME [flags]

Arguments

APP_NAME

    İzinlerin alındığı veya yönetildiği uygulama.

Options

--json JSON

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

Genel bayraklar

Examples

Aşağıdaki örnek, JSON yapılandırmasını kullanarak izinleri ayarlar:

databricks apps set-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_USE"}]}'

databricks uygulamaları izinleri güncelleme

Bir uygulama üzerindeki izinleri güncelleştirin. Uygulamalar izinleri kök nesnelerinden devralabilir.

databricks apps update-permissions APP_NAME [flags]

Arguments

APP_NAME

    İzinlerin alındığı veya yönetildiği uygulama.

Options

--json JSON

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

Genel bayraklar

Examples

Aşağıdaki örnek, JSON yapılandırmasını kullanarak izinleri güncelleştirir:

databricks apps update-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_MANAGE"}]}'

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