SQL JupyterLab SQL延伸模組的編輯器功能 - Amazon SageMaker

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

SQL JupyterLab SQL延伸模組的編輯器功能

SQL 延伸模組提供魔術命令，可啟用 JupyterLab 筆記本儲存格內的SQL編輯器功能。

如果您是 SageMaker 分佈映像 1.6 版的使用者，您必須透過在 JupyterLab 筆記本%load_ext amazon_sagemaker_sql_magic中執行 來載入SQL擴充魔術程式庫。這會開啟SQL編輯功能。

對於 SageMaker 分佈映像 1.7 版及更新版本的使用者，不需要採取任何動作，SQL擴充功能會自動載入。

載入擴充功能後，請在儲存格開頭新增%%sm_sql魔術命令，以啟用SQL編輯器的下列功能。

  • Connection-selection 下拉式清單 ：將%%sm_sql魔術命令新增至儲存格時，下拉式功能表會顯示在儲存格頂端，並包含可用的資料來源連線。選取連線以自動填入查詢資料來源所需的參數。以下是選取名稱為 的連線所產生的%%sm_sql魔術命令字串範例connection-name。

    %%sm_sql --metastore-type GLUE_CONNECTION --metastore-id connection-name

    使用以下SQL編輯器的功能來建置您的SQL查詢，然後執行儲存格以執行查詢。如需SQL執行功能的詳細資訊，請參閱 SQL JupyterLab SQL延伸模組的執行功能。

  • 查詢結果下拉式清單 ：您可以從連線選擇下拉式功能表旁的下拉式功能表中選取結果類型，以指定如何呈現查詢結果。選擇下列兩種替代方案：

    • 儲存格輸出：（預設） 此選項會在筆記本儲存格輸出區域中顯示查詢的結果。

    • Pandas Dataframe ：此選項 DataFrame 會將查詢結果填入 panda。額外的輸入方塊可讓您在選擇此選項 DataFrame 時命名 。

  • SQL 語法反白顯示 ：儲存格會自動依顏色和樣式以視覺方式區分SQL關鍵字、子句、運算子等。這可讓SQL程式碼更容易閱讀和理解。關鍵字，例如 SELECT、WHERE、 FROM和 內建函數，例如 SUM和 COUNT，或 等子句GROUP BY，以不同的顏色和粗體樣式反白顯示。

  • SQL 格式設定 ：您可以透過下列其中一種方式，將一致的縮排、大寫、間距和換行套用至群組或分開的SQL陳述式和子句。這可讓SQL程式碼更容易閱讀和理解。

    • 在SQL儲存格上按一下滑鼠右鍵，然後選擇格式 SQL。

    • 當SQL儲存格成為焦點時，請使用 Windows 上的 ALT + F 快速鍵，或 MacOS 上的選項 + F。

  • SQL 自動完成 ：擴充功能會在您輸入SQL時提供關鍵字、函數、資料表名稱、資料欄名稱等的自動建議和完成。當您開始輸入SQL關鍵字，例如 SELECT或 時WHERE，延伸模組會顯示快顯視窗，其中包含自動完成其餘字詞的建議。例如，在輸入資料表或資料欄名稱時，它建議與資料庫結構描述中定義的資料表和資料欄名稱相符。

    重要

    若要在 JupyterLab 筆記本中啟用SQL自動完成，分發映像 1.6 版的使用者 SageMaker必須在終端機中執行下列npm install -g vscode-jsonrpc sql-language-server命令。安裝完成後，執行 以重新啟動 JupyterLab 伺服器restart-jupyter-server。

    對於 SageMaker 分佈映像 1.7 版及更新版本的使用者，不需要採取任何動作。

    儲存格提供兩種自動完成已辨識SQL關鍵字的方法：

    • 明確調用 （建議）：選擇 Tab 鍵以啟動內容感知建議功能表，然後選擇輸入以接受建議項目。

    • 持續提示：儲存格會在您輸入時自動建議完成。

    注意

    • 只有在SQL關鍵字為大寫時，才會觸發自動完成。例如，輸入 的SEL提示SELECT，但輸入sel不會。

    • 第一次連線到資料來源時，SQL自動完成會為資料來源的中繼資料編製索引。此索引程序可能需要一些時間才能完成，具體取決於資料庫的大小。