Citus 分布式 PostgreSQL 集群 – SQL Reference(SQL支持和变通方案)

由于Citus 通过扩展PostgreSQL 提供分布式功能，因此它与PostgreSQL 结构兼容。这意味着用户可以使用丰富且可扩展的PostgreSQL 生态系统附带的工具和功能来处理使用Citus 创建的分布式表。

Citus 对它能够在单个工作节点上执行的任何查询具有100% 的SQL 覆盖率。 在访问有关单个租户的信息时，此类查询在多租户应用程序中很常见。

甚至跨节点查询（用于并行计算）也支持大多数SQL 功能。 但是，组合来自多个节点的信息的查询不支持某些SQL 功能。

跨节点 SQL 查询的限制：

• SELECT … FOR UPDATE 仅适用于单分片查询
• TABLESAMPLE 仅适用于单分片查询
• 关联子查询仅当关联在分布列上时才受支持。
• 分布式表之间的外连接仅在分布列上受支持。
• 仅当分布式表在外侧时，才支持分布式表和引用表或本地表之间的外连接
• 递归 CTE 仅适用于单分片查询
• 分组集仅适用于单分片查询

要了解有关PostgreSQL 及其功能的更多信息，您可以访问PostgreSQL 文档。有关PostgreSQL SQL 命令方言（可供Citus 用户按原样使用）的详细参考，您可以查看SQL 命令参考。

变通方案

在尝试变通方案之前，请考虑Citus 是否适合您的情况。Citus 当前版本适用于实时分析和多租户用例。

Citus 支持多租户用例中的所有SQL 语句。即使在跨节点查询的实时分析用例中，Citus 也支持大多数语句。Citus 不支持的PostgreSQL 特性中列出了几种不受支持的查询类型？ 许多不受支持的功能都有变通方案；以下是一些最有用的。

使用 CTE 解决限制

当SQL 查询不受支持时，解决它的一种方法是使用CTE，它使用我们所谓的pull-push 执行。

SELECT * FROM ref LEFT JOIN dist USING (id) WHERE dist.value > 10; /* ERROR:  cannot pushdown the subquery DETAIL:  There exist a reference table in the outer part of the outer join */

要解决此限制，您可以通过将分布式部分包装在CTE 中来将查询转换为路由器查询

WITH x AS (SELECT * FROM dist WHERE dist.value > 10) SELECT * FROM ref LEFT JOIN x USING (id);

请记住，coordinator 会将CTE 的结果发送给所有需要它进行处理的worker。 因此，最好将最具体的过滤器和限制添加到内部查询中，或者聚合表。 这减少了此类查询可能导致的网络开销。在子查询/CTE 网络开销中了解更多信息。

临时表：不得已的解决方法

即使通过子查询使用推拉执行，仍有一些查询不受支持。其中之一是在分布式表上使用分组集。

在我们的实时分析教程中，我们创建了一个名为github_events 的表，由user_id 列分布。让我们查询它并找到一组预选的repos 的最早事件，按事件类型和事件公开的组合分组。一种方便的方法是使用分组集。 但是，如前所述，分布式查询尚不支持此功能：

-- this won't work   SELECT repo_id, event_type, event_public,          grouping(event_type, event_public),          min(created_at)     FROM github_events    WHERE repo_id IN (8514, 15435, 19438, 21692) GROUP BY repo_id, ROLLUP(event_type, event_public);

ERROR:  could not run distributed query with GROUPING HINT:  Consider using an equality filter on the distributed table's partition column.

不过，有一个窍门。我们可以将相关信息作为临时表拉取到coordinator：

-- grab the data, minus the aggregate, into a local table  CREATE TEMP TABLE results AS (   SELECT repo_id, event_type, event_public, created_at     FROM github_events        WHERE repo_id IN (8514, 15435, 19438, 21692)     );  -- now run the aggregate locally    SELECT repo_id, event_type, event_public,          grouping(event_type, event_public),          min(created_at)     FROM results GROUP BY repo_id, ROLLUP(event_type, event_public);

 repo_id |    event_type     | event_public | grouping |         min ---------+-------------------+--------------+----------+---------------------     8514 | PullRequestEvent  | t            |        0 | 2016-12-01 05:32:54     8514 | IssueCommentEvent | t            |        0 | 2016-12-01 05:32:57    19438 | IssueCommentEvent | t            |        0 | 2016-12-01 05:48:56    21692 | WatchEvent        | t            |        0 | 2016-12-01 06:01:23    15435 | WatchEvent        | t            |        0 | 2016-12-01 05:40:24    21692 | WatchEvent        |              |        1 | 2016-12-01 06:01:23    15435 | WatchEvent        |              |        1 | 2016-12-01 05:40:24     8514 | PullRequestEvent  |              |        1 | 2016-12-01 05:32:54     8514 | IssueCommentEvent |              |        1 | 2016-12-01 05:32:57    19438 | IssueCommentEvent |              |        1 | 2016-12-01 05:48:56    15435 |                   |              |        3 | 2016-12-01 05:40:24    21692 |                   |              |        3 | 2016-12-01 06:01:23    19438 |                   |              |        3 | 2016-12-01 05:48:56     8514 |                   |              |        3 | 2016-12-01 05:32:54

在coordinator 上创建临时表是最后的手段。它受节点的磁盘大小和CPU 的限制。

更多

1. Citus 分布式 PostgreSQL 集群 - SQL Reference(创建和修改分布式表 DDL)
2. Citus 分布式 PostgreSQL 集群 - SQL Reference(摄取、修改数据 DML)
3. Citus 分布式 PostgreSQL 集群 - SQL Reference(查询分布式表 SQL)
4. Citus 分布式 PostgreSQL 集群 - SQL Reference(查询处理)