定价
登录 开始使用
文档 学习
首页
课程
Metabase 基础知识
提升您的数据技能
速查表

调试 SQL 语法错误

查询返回错误消息时该怎么办。

阅读错误消息不应该感觉像是在解谜。本调试指南解释了您可以如何处理拒绝运行的顽固查询。

调试 SQL 查询

如果您的 SQL 查询包含看起来像 {{ variable }} 的 SQL 变量，请先转到SQL 变量故障排除。

  1. 转到 SQL 查询中失败的行。
  2. 检查 SQL 查询中失败的行上的SQL 语法。
  3. 如果查询使用连接、子查询或 CTE，请检查您的查询逻辑。
  4. 如果您收到的错误消息并非特定于您的 SQL 查询，请转到错误消息故障排除。

SQL 调试如何工作？

  • SQL 错误消息会针对查询中未能运行的每一行显示。您需要对每一条失败的行执行上述步骤。
  • 如果您对某一行进行了任何更改，请运行查询以检查问题是否已修复，然后再继续下一步。您可以在查询末尾添加 LIMIT 子句以加快该过程。
  • 请注意，SQL 查询不是从上到下运行的，因此您不会按照编写顺序调试查询行。请按照错误消息的提示查找需要注意的行。

调试 SQL 语法

  1. 检查 SQL 查询中失败的行上的拼写。
  2. 检查 SQL 查询中失败的行上是否缺少括号或逗号。
  3. 删除注释行（以 -- 或 /* 开头的行）。
  4. 查看 特定于您的 SQL 方言的常见语法错误。

说明

您的数据库需要能够“读取”您的查询才能执行它。

  • 正确的拼写会准确地告诉您的数据库要查找什么。
  • 标点符号会告诉您的数据库如何（例如，使用什么顺序）查找您的数据。
  • 注释并非旨在被读取或执行，但有时尾随空格或符号可能会意外地干扰相邻行的读取和执行。

常见 SQL 参考指南

在开始之前，请打开您正在使用的 SQL 方言的 SQL 参考指南。我们在此处链接了一些最常见的指南

常见 SQL 语法错误

您的错误消息说了什么？

列名或表名“未找到”或“无法识别”

如果您的 SQL 查询包含看起来像 {{ variable }} 的 SQL 变量，请先转到SQL 变量故障排除。

步骤

  1. 查看参考指南中您的 SQL 方言的结构部分。

    • 您是否使用了正确的引号？例如

      • SELECT 'column_name'
      • SELECT "column_name"
      • SELECT `column_name`

    • 您是否使用了正确的列和表路径？例如

      • FROM table_name
      • FROM schema_name.table_name
      • FROM database_name.schema_name.table_name

    • 您的列名是否是保留字？例如

      在 PostgresSQL 中，“users”是保留关键字.

      • SELECT users 将抛出错误。
      • SELECT "users" 将正确运行。

    • 提示：使用 Metabase 检查列名和表名语法

      1. 在查询构建器中使用与您的 SQL 问题相同的列和表创建一个问题。
      2. 将问题转换为 SQL.
      3. 查看 Metabase 生成的 SQL 查询如何引用列名和表名。

  2. 查看查询中列名和表名的数据参考。

    • 如果数据参考中不存在列名或表名

      • 运行 SELECT * FROM your_table_name LIMIT 10; 以查找要在查询中使用的列名或表名。
      • 如果您是 Metabase 管理员，请检查数据模型页面的原始架构。

    • 如果列名存在，但您无法从 SQL 编辑器查询该列

      • 询问您的 Metabase 管理员该列是否已在数据库端重命名或删除。
      • 如果您是 Metabase 管理员，您可能需要运行同步以刷新您的数据。

说明

您需要确保为数据库使用的 SQL 方言使用正确的语法。

您的查询还需要使用与数据库中原始名称匹配的列名和表名。Metabase 使用 Metabase 管理员可以更新的显示名称，因此数据参考可能与您的数据库架构不匹配。列或表也可能已在数据库端重命名，但 Metabase 尚未运行同步来获取更新。

延伸阅读

SQL 函数不存在

如果您的 SQL 查询包含看起来像 {{ variable }} 的 SQL 变量，请先转到SQL 变量故障排除。

步骤

  1. 查看您希望函数应用于的列的数据类型。

    • 您可以使用 Metabase数据参考来查看列的字段类型（作为数据类型的代理）。
    • 如果您有权访问信息模式，也可以直接在数据库中查询信息模式。

  2. 查看参考指南中您的 SQL 方言的函数部分。

    • 确认该函数存在于您的 SQL 方言中。
    • 查看您的函数接受的数据类型。

  3. 如果您的列的字段类型与您的函数的预期数据类型不匹配

说明

SQL 函数旨在处理数据库中的特定数据类型。例如，PostgresSQL 中的 DATE_TRUNC 函数适用于 Postgres 数据库中类型为 date、timestamp 和 time 的数据列。如果您尝试在数据库中数据类型为 string 的列上使用 DATE_TRUNC 函数，它将无法工作。

请注意，Metabase字段类型与数据库中的数据类型不是一对一的。在这种情况下，字段类型为您提供了有关列数据类型的足够信息，以排除错误。

延伸阅读

如何在 SQL 查询中查找失败的行

如果您的 SQL 查询包含看起来像 {{ variable }} 的 SQL 变量，请先转到SQL 变量故障排除。

找到 SQL 查询中失败的行后，请转到调试 SQL 查询下的步骤。

阅读您的 SQL 错误消息

您的错误消息是否

  • 告诉您行或字符位置？
  • 包含表名或列名？如果表名或列名在查询中出现多次，请缩小查询的大小。
  • 提及 SQL 子句？

缩小 SQL 查询的大小

如果您的查询使用

  • 子查询（嵌套查询），请分别运行每个子查询。从内部子查询开始，然后逐步向外运行。
  • CTE，请分别运行每个 CTE。从您的基本 CTE 开始，然后逐步向下运行查询。
  • 指向 Metabase 模型的 SQL 变量，分别运行每个模型。通过打开变量面板转到模型，或者在 Metabase 搜索栏中输入模型 ID 号。
  • 请记住在尝试找出问题时阅读 SQL 错误消息。有关更多信息，请转到SQL 调试如何工作？。

在 SQL 编辑器中工作的技巧

突出显示 SQL 查询的行以

  • 使用 Cmd + Return 或 Ctrl + Enter 运行这些行。
  • 使用 Cmd + / 或 Ctrl + / 注释/取消注释这些行。

如何找出要使用的 SQL 方言

SQL 方言基于存储要查询表的数据库。 找出要使用的 SQL 方言后，您可以按照调试 SQL 查询下的步骤操作。

要找出您正在查询哪个数据库

  • 如果您是 Metabase 管理员，请转到管理设置 > 数据库，并在引擎列下查找。
  • 否则，请咨询设置 Metabase 的人员。

您有其他问题吗？

您仍然遇到困难吗？

搜索或询问 Metabase 社区。

下一步：调试 SQL 查询逻辑

当您的查询返回的数据看起来不正确时该怎么办。

下一篇文章