从 Timescale Console 运行查询

由于 Timescale Cloud 基于 PostgreSQL，您可以使用许多不同工具连接到您的服务并与您的数据进行交互。

在 Timescale Console 中，您可以通过以下方式对服务运行 SQL 查询：

• 数据模式：由 PopSQL 提供支持的丰富体验。您可以编写带有自动补全的查询，将它们保存在文件夹中，共享它们，创建图表/仪表板等等。

• 数据模式中的 SQL 助手：更快、更准确地编写、修复和组织 SQL。

• 操作模式中的 SQL 编辑器：操作模式中的一个简单 SQL 编辑器，允许您运行临时查询。这对于创建小表上的索引或检查pg_stat_statements等快速一次性任务很有用。

如果您更喜欢命令行而不是 Timescale Console 中的操作模式 SQL 编辑器，请使用psql。

您可以使用 Timescale Console 中的数据模式来编写查询、可视化数据和共享结果。

展开图片

可用功能包括：

• 实时协作：通过实时状态和多个光标，直接在数据模式查询编辑器中与您的团队协作。
• Schema 浏览器：了解服务的结构，并查看表和列的使用数据。
• SQL 助手：使用 AI 更快、更准确地编写、修复和组织 SQL。
• 自动补全：在您键入查询时获取建议。
• 版本历史：从内置修订历史中访问查询的早期版本，或连接到 git 仓库。
• 图表：直接在 UI 中可视化数据，而无需切换到表格或 Excel。
• 计划：自动刷新查询和仪表板以创建推送警报。
• 查询变量：使用 Liquid 参数化您的查询或使用 if 语句。
• 跨平台支持：通过Timescale Console或下载适用于 macOS、Windows 和 Linux 的桌面应用程序。
• 轻松连接：连接到 Timescale Cloud、PostgreSQL、Redshift、Snowflake、BigQuery、MySQL、SQL Server 和更多。

现在您已经使用了 Timescale Console 中的数据模式，请查看如何轻松执行以下操作：

• 编写查询
• 与您的团队成员共享查询
• 从您的数据创建图表
• 创建包含多个查询结果的仪表板" width="16" height="16" class="inline m-0 ml-1">
• 为您的查询创建计划" width="16" height="16" class="inline m-0 ml-1">

如果您的 Timescale Cloud 服务在 VPC 内运行，请执行以下任一操作以启用 PopSQL 桌面应用程序的访问：

• 使用 PopSQL 的桥接连接器" width="16" height="16" class="inline m-0 ml-1">。
• 使用 SSH 隧道：在 PopSQL 中配置连接时，在高级选项下启用通过 SSH 连接。
• 将 PopSQL 的静态 IP（23.20.131.72, 54.211.234.135）添加到您的允许列表。

您获得的数据模式席位数取决于您的定价计划" width="16" height="16" class="inline m-0 ml-1">。

需要考虑几个因素：

1. 您的服务实例大小是多少？
2. 有多少用户正在运行查询？
3. 查询的计算密集度如何？

如果只有少量用户对具有足够资源的服务运行高性能 SQL 查询，则性能不应出现下降。但是，如果有很多用户运行查询，或者查询计算成本很高，最佳实践是创建只读副本并将分析查询发送到那里。

如果您想防止插入或更新等写操作，而不是使用tsdbadmin用户，请为您的服务创建一个只读用户并在数据模式下使用该用户。

Timescale Console中的 SQL 助手是一个聊天式界面，它利用 AI 的强大功能帮助您更快、更准确地编写、修复和组织 SQL。您可以要求 SQL 助手更改现有查询、从头开始编写新查询、调试错误消息、优化查询性能、添加注释、提高可读性，以及真正地回答您能想到的任何问题。

SQL 助手提供了一系列功能，以改善您的 SQL 工作流程，包括：

• 实时帮助：SQL 助手提供上下文帮助，以编写和理解 SQL。使用它来：

  • 理解函数：需要了解LAG()或ROW_NUMBER()等函数如何工作？SQL 助手会提供示例进行解释。
  • 解释复杂查询：SQL 助手会分解复杂的查询，让您清晰地看到每个部分。

• 错误解决：SQL 助手会在错误发生时进行诊断，您可以无需离开编辑器即可解决问题。功能包括：

  • 错误调试：如果您的查询失败，SQL 助手会识别问题并建议修复方法。
  • 性能调优：对于运行缓慢的查询，SQL 助手会提供优化建议以立即提高性能。

• 查询组织：为了让您的查询库保持整洁，并帮助您的团队理解每个查询的目的，SQL 助手会自动为您的查询添加标题和摘要。

• 代理模式：为了以最少的参与获得结果，SQL 助手会自动执行复杂任务并自行解决问题。无需逐步操作、分析错误和尝试解决方案。只需在 LLM 选择器中打开代理模式，然后看着 SQL 助手为您完成所有工作。建议在您的数据库连接配置为只读凭据时使用。

SQL 助手支持大量 LLM，包括：

• GPT-4o mini
• GPT-4o
• GPT-4.1 nano
• GPT-4.1 mini
• GPT-4.1
• o4-mini (低)
• o4-mini
• o4-mini (高)
• o3 (低)
• o3
• o3 (高)
• Claude 3.5 Haiku
• Claud 3.7 Sonnet
• Claud 3.7 Sonnet (扩展思考)
• Llama 3.3 70B Versatile
• Llama 3.3 70B Instruct
• Llama 3.1 405B Instruct
• Llama 4 Scout
• Llama 4 Maverick
• DeepSeek R1 Distill - Llama 3.3. 70B
• DeepSeek R1
• Gemini 2.0 Flash

根据手头的特定任务选择 LLM。对于更简单的任务，请尝试使用更小、更快的模型，如 Gemini Flash、Haiku 或 o4-mini。对于更复杂的任务，请尝试使用更大的推理模型，如 Claude Sonnet、Gemini Pro 或 o3。我们提供了每个模型的描述，以帮助您做出决定。

为了获得 SQL 助手的最佳结果：

• 模式感知：SQL 助手会引用模式数据，但在复杂环境中可能需要额外上下文。根据需要指定表、列或连接。
• 业务逻辑：SQL 助手本身不知道“活跃用户”等特定业务术语。明确定义这些术语以改善结果。

Timescale Console 优先考虑安全和隐私。在数据模式，项目成员可以在用户名 > 设置 > SQL 助手下管理 SQL 助手设置。

展开图片

SQL 助手设置如下：

• 可选功能：所有 AI 功能默认关闭。只有您的 Timescale Cloud 项目的成员才能启用它们。
• 数据保护：您的数据保持私密，因为 SQL 助手严格遵循安全协议。为了提供 AI 支持，Timescale 可能会共享您当前打开的 SQL 文档、有关数据库的一些基本元数据以及数据库模式的一部分。默认情况下，Timescale 不包含任何查询结果中的数据，但您可以选择包含此上下文以改进结果。
• 样本数据：为了向 LLM 提供更多上下文，从而获得更好的 SQL 建议，请在 SQL 助手偏好设置中启用样本数据共享。
• 遥测：为了改进 SQL 助手，Timescale 收集遥测和使用数据，包括提示、响应和查询元数据。

SQL 编辑器是一个集成的安全 UI，您可以使用它来运行查询并查看 Timescale Cloud 服务的结果。

展开图片

要启用或禁用服务中的 SQL 编辑器，请单击操作 > 服务管理，然后更新 SQL 编辑器的设置。

• 操作模式下的 SQL 编辑器：拥有Timescale Cloud 账户的任何人均可免费使用。
• 数据模式：您获得的席位数取决于您的定价计划。目前，SQL 助手对所有用户免费。未来，随着我们努力构建最佳体验，可能会引入限制或付费选项。
• PopSQL 独立版：提供免费计划以及付费计划。有关详细信息，请参阅PopSQL 定价。

下一步是什么？尝试 Timescale 提供的主要功能，查看使用案例教程，使用您喜欢的编程语言与 Timescale Cloud 服务中的数据进行交互，将您的 Timescale Cloud 服务与一系列第三方工具集成，或直接使用 Timescale，或者深入了解API。