SQLTools for Visual Studio Code的Databricks驱动程序

预览

此功能已在公共预览

SQLTools的Databricks驱动使您能够使用SQLTools扩展Visual Studio代码在远程Databricks工作空间中浏览SQL对象和运行SQL查询。

在开始之前

在您可以为SQLTools使用Databricks驱动程序之前,您的Databricks工作空间和本地开发机器必须满足以下要求。

工作空间的需求

您必须至少有一个可用的Databricks工作空间,并且该工作空间必须满足以下要求:

个人访问令牌

你一定有个数据库个人访问令牌.另请参阅管理个人访问令牌

本地开发机要求

您的本地开发机器上必须有以下文件:

  • Visual Studio Code版本1.70或更高。要查看已安装的版本,请单击关于Visual Studio代码从Linux或macOS上的manin菜单和>关于在Windows上。要下载、安装和配置Visual Studio代码,请参见设置Visual Studio代码

  • SQLToolsVisual Studio Code扩展。

  • SQLTools的Databricks驱动Visual Studio Code扩展。

要安装SQLTools扩展,请转到SQLTools然后点击安装或:

  1. 在“Visual Studio Code”中,单击查看>扩展在主菜单上。

  2. 市场搜索扩展框中,输入SQLTools

  3. 单击SQLTools条目从Matheus特谢拉

    请注意

    可能有多个SQLTools列出的条目。请确保单击来自的条目Matheus特谢拉

  4. 点击安装

安装SQLTools扩展Databricks Driver,请转到SQLTools的Databricks驱动然后点击安装或:

  1. 在“Visual Studio Code”中,单击查看>扩展在主菜单上。

  2. 市场搜索扩展框中,输入司机SQLTools

  3. 单击SQLTools的Databricks驱动条目。

  4. 点击安装

连接到模式

  1. 在Visual Studio Code的侧边栏上,单击SQLTools图标。

  2. SQLTools视图,在连接窗格,如果这是您第一次使用SQLTools扩展,请单击添加新连接.否则,请单击添加新连接窗格标题栏中的图标。

  3. SQLTools设置选项卡,用于选择数据库驱动程序步骤,单击图标。

  4. 连接设置步骤,输入关于仓库、目录和模式的以下信息:

    1. 连接名,为这个连接输入一些唯一的名称。

    2. (可选)连接组,您可以输入一些惟一的名称来创建新连接将添加到的新连接组,或者输入新连接将添加到的现有连接组的名称。连接组使您能够将连接组织成组,以便在扩展中更容易找到它们。保留此空白以不将新连接添加到任何连接组。

    3. 宿主,进入仓库服务器主机名设置。得到一个仓库服务器主机名设置,请参阅获取SQL仓库的连接详细信息

    4. 路径,进入仓库或集群HTTP路径设置。得到一个仓库HTTP路径设置,请参阅获取SQL仓库的连接详细信息

    5. 令牌,输入Databricks个人访问令牌值。

    6. 目录,输入目录的名称。

      请注意

      对于未启用Unity Catalog的工作区,您可以离开目录的默认值hive_metastore

    7. 模式,输入模式的名称。

    8. (可选)显示记录默认限制,默认为50为每个查询只显示前50行,或输入不同的限制。

  5. 点击测试连接

  6. 如果测试连接成功,单击保存联系

更改连接的设置

此过程假设您已经成功连接到至少一个仓库。

  1. 如果SQLTools视图不可见,则在Visual Studio Code的侧栏上单击SQLTools图标。

  2. 连接窗格中,如果目标连接存在连接组,则展开该连接组。

  3. 右键单击该连接,然后单击编辑连接

  4. 修改目标设置。

  5. 点击测试连接

  6. 如果测试连接成功,单击保存联系

浏览模式的对象

  1. 连接窗格中,如果目标连接存在连接组,则展开该连接组。

  2. 双击或展开仓库的目标连接。

  3. 如果您的连接存在目标数据库(模式),则展开目标数据库(模式)。

  4. 扩大的观点,如果您的数据库(模式)存在一个或多个表或视图。

  5. 展开任何目标表或视图以查看表或视图的列。

查看表或视图的行或模式

的观点连接窗格中,执行以下操作之一:

  • 要显示表或视图的行,右键单击表或视图,然后单击显示表记录显示视图记录

  • 要显示表或视图的模式,右键单击表或视图,然后单击描述表描述视图

为表生成插入查询

  1. 将光标放在现有编辑器中要添加插入查询的位置。

  2. 连接窗格中,右键单击表,然后单击生成插入查询.插入查询的定义被添加到游标的插入点。

创建并运行查询

此过程假设您已经成功连接到至少一个仓库。

  1. 连接窗格中,如果目标连接存在连接组,则展开该连接组。

  2. 双击或展开仓库的目标连接。

  3. 选择连接后,单击新建SQL文件连接窗格的标题栏。出现一个新的编辑器选项卡。

  4. 在新的编辑器中输入SQL查询。

  5. 单击,执行SQL查询在活动连接上运行在编辑器中。查询结果显示在一个新的编辑器选项卡中。

运行一个现有的查询

此过程假设您已经成功连接到至少一个仓库。

  1. 连接窗格中,如果目标连接存在连接组,则展开该连接组。

  2. 双击或展开仓库的目标连接。

  3. 选择连接后,打开文件扩展名为的任何文件. sql,或在先前打开的任何编辑器中选择任意组连续SQL语句。

  4. 从打开的数据库中运行SQL查询. sql档案,连同你的. sql文件的内容显示在编辑器中,单击在活动连接上运行在编辑器中。查询结果显示在一个新的编辑器选项卡中。

  5. 若要在先前打开的编辑器中运行选定的连续SQL语句组,请右键单击所选内容,然后单击运行选定查询.查询结果显示在一个新的编辑器选项卡中。

额外的资源