`auth` 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.

auth Databricks CLI içindeki komut grubu, aşağıdakiler de dahil olmak üzere kimlik doğrulamasıyla ilgili komutları içerir:

Kullanılabilir kimlik doğrulama yapılandırma profillerini listeleyin.
Tek bir kimlik doğrulama yapılandırma profili hakkında bilgi edinin.
Azure Databricks hesaplarınızla ve çalışma alanlarınızla Databricks CLI kimliğini doğrulamak için OAuth kullanıcıdan makineye (U2M) kimlik doğrulamasını kullanın.
Databricks CLI'nın önbelleğe almış olabileceği OAuth erişim belirteçleri hakkında bilgi edinin.
Databricks CLI'nın kimlik doğrulaması için kullandığı yapılandırma hakkında ayrıntılı bilgi edinin.

Tip

Geçerli Databricks CLI kullanıcısı hakkında bilgi almak için komutunu çalıştırın databricks current-user me.

databricks kimlik doğrulaması açıklama

Databricks CLI'nın kimlik bilgileri ve bu kimlik bilgilerinin kaynağı dahil olmak üzere kimlik doğrulaması için kullandığı yapılandırmayı açıklar. Hiçbir seçenek belirtilmezse, auth describe komut Kimlik doğrulama yöntemi önceliğini izler.

databricks auth describe [flags]

Seçenekler

--sensitive

Çıktıya parolalar ve belirteçler gibi hassas alanlar ekleyin

Genel bayraklar

Örnekler

Aşağıdaki örnekte geçerli kimlik doğrulama yapılandırması açıklanmaktadır:

databricks auth describe

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from <path>/<to>/.databrickscfg config file)
  ✓ profile: default
  ✓ auth_type: <authentication-type> (from <path>/<to>/.databrickscfg config file)

Belirli bir Azure Databricks çalışma alanıyla ilgili bilgilerin kullanılacağını belirtmek için çalışma alanının URL'si ile birlikte seçeneğini belirtin --host .

databricks auth describe --host https://<workspace-instance-name>

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from --host flag)
  ✓ profile: default
  ✓ auth_type: <authentication-type>

Belirli bir Azure Databricks hesabıyla ilgili bilgilerin kullanıldığını belirtmek için Azure Databricks hesap konsolu URL'si --hostile birlikte seçeneğini belirtinhttps://accounts.azuredatabricks.net.

databricks auth describe --host <account-console-url>

Host: <account-console-url>
User: <user-name>@<domain>
AccountId: <account-id>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: <account-console-url> (from --host flag)
  ✓ account_id: <account-id>
  ✓ profile: default
  ✓ auth_type: <authentication-type>

Belirli bir Azure Databricks yapılandırma profiliyle ilgili bilgilerin kullanılacağını belirtmek için, profilin -p adıyla birlikte veya --profile seçeneğini belirtin:

databricks auth describe -p TEST

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from <path>/<to>/.databrickscfg config file)
  ✓ token: ******** (from <path>/<to>/.databrickscfg config file)
  ✓ profile: TEST (from --profile flag)
  ✓ auth_type: <authentication-type>

Çıktıya hassas bilgileri (Azure Databricks kişisel erişim belirteçleri ve istemci gizli dizileri gibi) eklemek için şu --sensitive seçeneği belirtin:

databricks auth describe --sensitive

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from <path>/<to>/.databrickscfg config file)
  ✓ token: <token-value> (from <path>/<to>/.databrickscfg config file)
  ✓ profile: <profile-name>
  ✓ auth_type: pat

Databricks kimlik doğrulama ortamı

Profilin adını veya Azure Databricks hesap konsolu URL'sini veya Azure Databricks çalışma alanı URL'sini kullanarak mevcut bir yapılandırma profili hakkında bilgi edinin.

databricks auth env [flags]

Tip

yapılandırma profili adını el ile girmek yerine, Tab veya --profile sonra -p tuşuna basarak seçebileceğiniz mevcut yapılandırma profillerinin listesini görüntüleyebilirsiniz.

Yapılandırma profili oluşturmak için komutunaconfigure bakın.

Seçenekler

--host string

Kimlik doğrulaması env'sini almak için ana bilgisayar adı

Note

Değerle --host eşleşen birden fazla profil varsa, eşleşen tek bir profil bulamadığını belirten bir hata görüntülenir. Örneğin, yalnızca bir konak değerine sahip bir profiliniz ve aynı ana bilgisayar değeriyle aynı zamanda belirteç değerine sahip başka bir profiliniz olabilir. Bu durumda Databricks CLI bir profil seçmez ve durur. Databricks CLI'sının istenen profili seçmesine yardımcı olmak için farklı --host bir değer belirtmeyi deneyin. Hesap konsolu URL'leri olan --host değerler için, --account-id değeri yerine bir --host değeri belirtmeyi deneyin.

--profile string

Kimlik doğrulaması için kullanılacak profil

Genel bayraklar

Örnekler

Aşağıdaki örnek varsayılan kimlik doğrulama ortamını alır:

databricks auth env

Aşağıdaki örnek belirli bir konağın kimlik doğrulama ortamını alır:

databricks auth env --host https://my-workspace.cloud.databricks.com

Azure Databricks erişim belirteci kimlik doğrulaması ile yapılandırılmış bir profilin çıktısı şu olabilir:

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "TEST",
    "DATABRICKS_HOST": "https://my-workspace.cloud.databricks.com",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

Aşağıdaki örnek, belirli bir profil için kimlik doğrulama ortamını alır:

databricks auth env --profile my-test-environment

Databricks çalışma alanında veya hesabında oturum açın ve kimlik doğrulama yapılandırmasını bir profile kaydedin (varsayılan olarak içinde ~/.databrickscfg ). Profil daha sonra bayrağını kullanarak --profile diğer Databricks CLI komutlarının kimliğini doğrulamak için kullanılabilir. Profil, Databricks Python, Java ve Go SDK'ları da dahil olmak üzere Databricks birleşik kimlik doğrulamasını destekleyen diğer Databricks araçlarının kimliğini doğrulamak için de kullanılabilir.

databricks auth login HOST [flags]

Bu komut bir Databricks ana bilgisayar URL'si (konumsal bağımsız değişken olarak --host veya belirtilen profil adından örtük olarak çıkarılarak) ve bir profil adının (kullanılarak --profile) belirtilmesi gerekir. Bu değerleri belirtmezseniz, çalışma zamanında değer girmeniz istenir.

Bu komut sizi her zaman belirtilen konakta günlüğe kaydederken, davranış yapılandırma dosyanızda ayarladığınız mevcut profillere bağlıdır ( ~/.databrickscfg varsayılan olarak):

Belirtilen ada sahip bir profil varsa ve bir konak belirtiyorsa, profil tarafından belirtilen konakta oturum açarsınız. Profil, daha önce böyle bir durum söz konusu değilse kimlik doğrulama türü olarak "databricks-cli" kullanacak şekilde güncelleştirilir.
Belirtilen ada sahip bir profil varsa ancak bir konak belirtmiyorsa, bir konak belirtmeniz istenir. Profil, belirtilen konağı kullanacak şekilde güncelleştirilir. Daha önce böyle bir durum söz konusu değilse kimlik doğrulama türü "databricks-cli" olarak güncelleştirilir.
Belirtilen ada sahip bir profil varsa ve bir konak belirtiyorsa, ancak (veya konum arg olarak--host) kullanarak HOST bir konak belirtirseniz, profil yeni belirtilen konağı kullanacak şekilde güncelleştirilir. Daha önce böyle bir durum söz konusu değilse kimlik doğrulama türü "databricks-cli" olarak güncelleştirilir.
Belirtilen ada sahip bir profil yoksa, belirtilen ana bilgisayarla yeni bir profil oluşturulur. Kimlik doğrulama türü "databricks-cli" olarak ayarlanır.

Tartışmalar

HOST

Databricks ana bilgisayar URL'si (isteğe bağlı)

Seçenekler

--configure-cluster

Kümeyi yapılandırma istemleri (klasik işlem)

--configure-serverless

Sunucusuz işlem yapılandırma istemleri

--timeout duration

Tarayıcıda oturum açma sınamasını tamamlama zaman aşımı (varsayılan 1h0m0s)

Genel bayraklar

Örnekler

Aşağıdaki örnek bir Databricks çalışma alanında oturum açar:

databricks auth login

Aşağıdaki örnek belirli bir Databricks çalışma alanında oturum açar:

databricks auth login https://my-workspace.cloud.databricks.com

Aşağıdaki örnek belirli bir profille oturum açar ve küme ayarlarını yapılandırılır:

databricks auth login --profile my-profile --configure-cluster

Aşağıdaki örnek, oturum açma işlemi için özel bir zaman aşımı ayarlar:

databricks auth login --timeout 30m

databricks kimlik doğrulama profilleri

Tüm kullanılabilir yapılandırma profillerini listeleyin ( ~/.databrickscfg varsayılan olarak) ve geçerli profil olup olmadıklarını denetleyin.

databricks auth profiles [flags]

Bu komut profilleri aşağıdaki biçimde çıkış yapar:

Name            Host                Valid
DEFAULT         https://<host-url>  YES
<profile-name>  https://<host-url>  NO

Databricks CLI, her profilin geçerli olup olmadığını belirlemek için her hesap düzeyindeki profilin çalışma alanlarını listeler ve her çalışma alanı düzeyinde profil için geçerli kullanıcı komutunu çalıştırır. Komut başarılı olursa, bir YES görüntülenir; aksi takdirde bir NO görüntülenir.

Komutun çıktısı auth profiles hiçbir erişim belirteci görüntülemez. Erişim belirtecini görüntülemek için bkz. databricks auth env.

Varsayılan olarak, yapılandırma profilleri Linux veya macOS ~/.databrickscfg ya da Windows üzerindeki dosyada %USERPROFILE%\.databrickscfg depolanır. ortam değişkenini DATABRICKS_CONFIG_FILEayarlayarak bu dosyanın varsayılan yolunu değiştirebilirsiniz.

Yapılandırma profilleri oluşturmak için komutunaconfigure bakın.

Seçenekler

--skip-validate

Profilleri doğrulamanın atlanıp atlanmayacağı

Genel bayraklar

Örnekler

Aşağıdaki örnek tüm kimlik doğrulama profillerini listeler:

databricks auth profiles

Aşağıdaki örnek, profilleri doğrulamadan listeler:

databricks auth profiles --skip-validate

databricks kimlik doğrulama belirteci

kimlik doğrulama belirtecini içindeki ~/.databricks/token-cache.jsonyerel önbellekten alın. Süresi dolduysa erişim belirtecini yenileyin. Bu komut yalnızca U2M kimlik doğrulamasıyla çalışır (komutunu kullanarak databricks auth login ). İstemci kimliği ve gizli dizi kullanan M2M kimlik doğrulaması desteklenmez.

databricks auth token [HOST] [flags]

OAuth U2M kimlik doğrulamasını yapılandırmak ve ayarlamak için bkz. OAuth kullanıcıdan makineye (U2M) kimlik doğrulaması.

Tartışmalar

HOST

Databricks Ana Bilgisayar URL'si (isteğe bağlı)

Seçenekler

--account-id string

Databricks Hesap Kimliği

--timeout duration

Belirteç almak için zaman aşımı. (varsayılan 1h0m0s)

Genel bayraklar

Örnekler

Aşağıdaki örnek kimlik doğrulama belirtecini alır:

databricks auth token

Aşağıdaki örnek belirli bir konak için kimlik doğrulama belirtecini alır:

databricks auth token https://my-workspace.cloud.databricks.com

Çıkış şu şekilde olabilir:

{
  "access_token": "<token-value>",
  "token_type": "Bearer",
  "expiry": "<token-expiration-date-time>"
}

Aşağıdaki örnek, belirteç alımı için özel bir zaman aşımı ayarlar:

databricks auth token --timeout 30m

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

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-10-24

Aracılığıyla paylaş

auth komut grubu

databricks kimlik doğrulaması açıklama

Seçenekler

Örnekler

Databricks kimlik doğrulama ortamı

Seçenekler

Örnekler

databricks kimlik doğrulaması oturum açma

Tartışmalar

Seçenekler

Örnekler

databricks kimlik doğrulama profilleri

Seçenekler

Örnekler

databricks kimlik doğrulama belirteci

Tartışmalar

Seçenekler

Örnekler

Genel bayraklar

Geri Bildirim

Ek kaynaklar

`auth` komut grubu