通过

快速入门：使用 Azure Data Studio 连接并查询 Azure 上的 Managed Service for TimescaleDB

重要

Azure Data Studio 将于 2026 年 2 月 28 日停用。 建议使用 Visual Studio Code。 有关迁移到 Visual Studio Code 的详细信息，请访问 Azure Data Studio 发生了什么情况？

本文介绍如何使用 Azure Data Studio 连接到 Azure 上的 Managed Service for TimescaleDB，然后使用 SQL 语句创建超表并对其进行查询。

先决条件

若要完成本快速入门，需要 Azure Data Studio、Azure Data Studio 的 PostgreSQL 扩展以及对 Azure 服务器上 Managed Service for TimescaleDB 的访问权限。

连接到 Azure 上的 Managed Service for TimescaleDB

  1. 启动“Azure Data Studio”。

  2. 第一次启动 Azure Data Studio 时，将打开“连接”对话框。 如果未打开“连接”对话框，请选择“服务器”页中的“新建连接”图标：

    “新建连接”图标的屏幕截图。

D:\GitHub\sql-docs-pr\docs\azure-data-studio\media\quicstart-timescaledb\new-connection-icon.png

  1. 在弹出的窗体中，转到“连接类型”，然后从下拉列表中选择“PostgreSQL” 。

  2. 使用 Azure 上 Managed Service for TimescaleDB 的主机、端口、用户、数据库名称和密码填写其余字段。

    “新建连接”屏幕的屏幕截图。

    设置 示例值 说明
    服务器名称 <REMOTE_HOST>.timescaledb.io Managed Service for TimescaleDB 服务的主机名。
    身份验证类型 密码 身份验证类型。
    用户名 tsdbadmin 你的用户名。
    密码(SQL 登录名) P@ssw0rd 你的密码。
    密码 检查 选中此框以避免每次连接时都输入密码。
    数据库名称 defaultdb Managed Service for TimescaleDB 服务的默认数据库为 defaultdb。 还可以指定数据库的名称。
    服务器组 默认值 使用此选项可以将此连接分配给你创建的特定服务器组。
    名称(可选) 留空 使用此选项可以为服务器指定一个易记名称。

  3. 选择“高级”。

  4. 在“端口”字段中，键入端口号，然后选择“确定”。

  5. 选择“连接”。

成功连接后，你的服务器将在“服务器”侧栏中打开。

创建超表

以下步骤在默认 defaultdb 数据库中创建一个超表：

  1. 在“服务器”边栏中，右键单击服务器并选择“新建查询”。

  2. 将以下 SQL 语句粘贴到查询编辑器中，并选择“运行”。

    注意

    可以在编辑器中追加此语句或覆盖现有查询。 选择“运行”将仅执行突出显示的查询。 如果未突出显示任何内容，则选择“运行”以执行编辑器中的所有查询。

    CREATE TABLE conditions ( -- create a regular table
time         TIMESTAMPTZ       NOT NULL,
location     TEXT              NOT NULL,
temperature  DOUBLE PRECISION  NULL);
SELECT create_hypertable('conditions', 'time'); -- turn it into a hypertable

插入行

将以下代码片段粘贴到查询窗口并选择“运行”：

INSERT INTO conditions
VALUES
  (NOW(), 'office', 70.0),
  (NOW(), 'basement', 66.5),
  (NOW(), 'garage', 77.0);

查询数据

  1. 将以下代码片段粘贴到查询编辑器中，并选择“运行”：

    -- Select rows from hyper table 'conditions'
SELECT * FROM conditions;

  2. 将显示查询结果：

    结果的屏幕截图。

后续步骤