磚CLI的遷移

卸載遺留CLI

如果你有你想要的遺留CLI安裝和卸載它,使用皮普(或pip3,這取決於您的Python版本)運行卸載命令,如下所示:

皮普卸載databricks-cli

安裝新的CLI

如果你不已經有了新的CLI安裝,安裝它,明白了設置CLI。

驗證CLI安裝

如果你不確定你是否使用新的CLI,按照說明在本節中,根據需要來驗證和調整。你遵循這些指令之前,確保退出任何Python虛擬環境,conda環境,或類似的環境。

檢查默認安裝CLI的版本,運行以下命令:

磚- v

如果版本號不是你期望什麼,做以下之一:

• 如果你想使用CLI的隻有一個版本:卸載以前版本的CLI不再需要使用。您可能需要更新您的操作係統的路徑這剩餘的版本的CLI的路徑,你想用上市。

• 如果你想繼續使用CLI的多個版本:預謀的完整路徑CLI的版本,您想要使用每個調用CLI。

• 如果你想繼續使用CLI的多個版本,但你不想保持將完整路徑CLI是你最經常使用的版本:確保完整路徑,首先列出在你的操作係統的版本路徑。請注意,您必須預先考慮的完整路徑中未列出的第一個版本的CLI您的操作係統路徑。

更新操作係統的路徑,請執行以下操作:

使用額外的身份驗證類型

遺留CLI和新的CLI都支持磚個人訪問令牌的身份驗證。然而,磚建議你使用其他的磚的身份驗證類型如果可能,隻有新的CLI支持。

個人訪問令牌認證,如果你必須使用磚磚建議你使用一個相關的服務主體而不是磚帳戶或用戶工作區。看到提供一個服務主體為磚自動化UI -磚。

新的CLI支持OAuth標記除了磚個人訪問令牌。這些額外的標記是更安全的,因為他們通常在一小時內到期,而磚個人訪問令牌可以無限期有效從一天到。這一點尤其重要,如果令牌是不小心簽入到版本控製係統,由其他人可以訪問。此外,新的CLI可以到期時自動刷新這些額外的令牌,而刷新數據磚個人訪問令牌是一個手動過程或很難自動化。

有關更多信息,請參見設置身份驗證。

命令組和命令的比較

下表列出了遺留CLI命令組和他們的新CLI命令組的等價物。綜合領先指標之間存在顯著差異,額外的表遺留CLI命令或選項列表及其新的CLI命令或選項的等價物。

違約和位置參數

大多數新的CLI命令至少有一個默認參數沒有一篇選項。一些新的CLI命令有兩個或兩個以上的位置參數,必須指定一個特定的順序,沒有相應的選項。這不同於遺留CLI,大多數命令對所有參數需要指定選項。例如,新的CLI集群得到命令以一個集群ID作為默認參數。然而,遺留CLIclusers得到命令要求您指定一個——cluster-id隨著集群ID選項。例如:

遺留CLI:

#這是遺留CLI。磚集群——cluster-id1234年567890 - a1b23c4d#這* *不* *處理遺留CLI——“錯誤:#失蹤。之一(“cluster-id”、“集群名稱”)必須提供。”磚集群獲得1234年567890 - a1b23c4d

新的CLI:

#這是新的CLI。磚集群獲得1234年567890 - a1b23c4d#這* *不* *使用新的CLI -“錯誤:未知的國旗:——cluster-id”磚集群——cluster-id1234年567890 - a1b23c4d

另外一個例子,新的CLI獎助金得到命令有兩個默認參數:可獲得的類型可到手的的全名緊隨其後。然而,遺留CLIunity-catalog權限得到命令要求您指定一個——< securable-type >選擇以及可獲得的的全名。例如:

遺留CLI:

磚unity-catalog main.default權限得到——模式

新的CLI:

#這是新的CLI。磚撥款模式main.default#這* *不* *使用新的CLI -“錯誤:未知的國旗:——模式”磚main.default贈款,模式

調試模式

遺留CLI提供了一個——調試選擇顯示整個堆棧跟蹤錯誤。新的CLI,——調試選擇是不認可。相反,使用以下選項:

• 使用——日誌文件<路徑>寫日誌信息到文件中指定<路徑>。如果不提供這個選項,日誌信息輸出到stderr。指定——日誌文件還沒有指定——進行日誌級別導致沒有日誌信息被寫入到文件中。

• 使用——日誌格式<類型>指定的格式記錄的信息。<類型>可以文本(默認,如果未指定)json。

• 使用——進行日誌級別<格式>指定級別的信息記錄。允許的值是禁用(默認,如果未指定)跟蹤,調試,信息,警告,錯誤。

遺留CLI,下麵的例子顯示了完整的堆棧跟蹤誤差:

磚fs ls /調試#輸出:## HTTP調試啟用# NoneType:沒有#錯誤:路徑/必須從“dbfs: /

新的CLI,下麵的例子完整的堆棧跟蹤記錄到一個文件中命名new-cli-errors.log在當前工作目錄中。堆棧跟蹤寫入JSON格式的文件:

磚fs ls /日誌文件new-cli-errors。日誌,日誌格式json,進行日誌級別跟蹤#輸出:##錯誤:預期dbfs路徑(dbfs: /前綴):/##(完整的堆棧跟蹤也寫入new-cli-errors。日誌文件)。

常見問題

本節列出了常見問題從遺留遷移到新的CLI。

磚CLI的<新版本號>在<新路徑>當前路徑找到喜歡跑步CLI < old-version-number > <舊路>因為安裝和可用的路徑,我假設你試圖運行新版本。如果你想禁用此行為可以設置DATABRICKS_CLI_DO_NOT_EXECUTE_NEWER_VERSION = 1。執行CLI <新版本號>…- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -磚CLI的<新版本號>

得到幫助

得到幫助從遺留CLI遷移到新的CLI,看到以下資源:

• 磚幫助中心

• 磚的辦公時間

• 磚的支持