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编辑器的以下功能。

  • 连接选择下拉列表：向单元格添加%%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 。当你选择此选项 DataFrame 时，一个额外的输入框可以让你命名。

  • SQL语法突出显示：该单元格通过颜色和样式自动直观地区分SQL关键字、子句、运算符等。这使得SQL代码更易于阅读和理解。诸如SELECT、FROMWHERE、之类的关键字以及诸如SUM和COUNT之类的内置函数或诸如GROUP BY之类的子句以不同的颜色和粗体样式突出显示。

  • SQL格式：您可以通过以下方式之一应用一致的缩进、大小写、间距和换行符对SQL语句和子句进行分组或分隔。这使得SQL代码更易于阅读和理解。

    • 右键单击SQL单元格并选择 “格式” SQL。

    • 当SQL单元格处于焦点时，在 Windows 上使用 ALT+ F 快捷键或在 macOS 上使用 Opti on + F 快捷方式。

  • SQLa@@ uto- completion：该扩展程序会在您键入时自动提供建议和完成SQL关键字、函数、表名、列名等。当你开始键入诸如SELECT或之类的SQL关键字时WHERE，扩展程序会显示一个弹出窗口，其中包含自动完成该单词其余部分的建议。例如，在键入表名或列名时，它会建议匹配数据库架构中定义的表名和列名。

    重要

    要在 n JupyterLab otebook 中启用SQL自动完成功能， SageMaker发行映像版本 1.6 的用户必须在终端中运行以下npm install -g vscode-jsonrpc sql-language-server命令。安装完成后，通过运行重新启动 JupyterLab 服务器restart-jupyter-server。

    对于 SageMaker 分发映像版本 1.7 及更高版本的用户，无需执行任何操作。

    该单元提供了两种自动填写已识别SQL关键字的方法：

    • 显式调用（推荐）：选择 T ab 键以启动上下文感知建议菜单，然后选择 Enter 以接受建议的项目。

    • 连续提示：当您键入时，单元格会自动建议完成内容。

    注意

    • 只有当SQL关键字为大写时，才会触发自动完成。例如，输入SEL提示SELECT，但sel不输入提示。

    • 首次连接到数据源时，SQL自动完成功能会为数据源的元数据编制索引。此索引过程可能需要一些时间才能完成，具体取决于数据库的大小。