Polars SQL 差异¶

数学

factorial(x)

fact(x)

阶乘函数。超出支持的整数阶乘范围的值返回 NULL。

polars-sql-test/new_sql_doc/functions-math.test

字符串

length(string)

char_length(string), character_length(string)

字符计数别名。

polars-sql-test/new_sql_doc/functions-string.test

字符串

starts_with(string, prefix)

startwith(string, prefix), beginwith(string, prefix)

前缀检查。

polars-sql-test/new_sql_doc/functions-string.test

字符串

strpos(string, substring), position(substring IN string)

find(substring, string)

从 1 开始计数的子串位置。未找到时 find 返回 0。

polars-sql-test/new_sql_doc/functions-string.test

日期和时间

date_add(unit, value, timestamp)

dateadd(unit, value, timestamp)

date_add 的别名。

polars-sql-test/new_sql_doc/functions-datetime.test

日期和时间

date_diff(unit, timestamp1, timestamp2)

date_diff(timestamp1, timestamp2, unit), datedif(timestamp1, timestamp2, unit)

差值方向相同：timestamp2 - timestamp1。

polars-sql-test/new_sql_doc/functions-datetime.test

functions.rst

从源文档继承而来的 lambda 函数、位运算函数、decimal 专用语义、二进制函数、JSON 函数、加噪聚合函数、数组函数、map 函数、URL 提取/编码函数、IP 地址函数、地理空间函数、HyperLogLog、KHyperLogLog、QDigest、UUID、TDigest、颜色函数、会话信息函数、Teradata 兼容函数、国际化函数、SetDigest、sketch、Pinot 下推函数、插件加载函数列表以及表函数。

这些函数系列中的标量、聚合或窗口特性没有经过支持验证。Polars SQL 中存在一些相近的专用函数，但它们并不是同一组已记录函数系列，也未列为等价语法。

针对保留函数系列的 Polars SQL 冒烟测试，以及针对代表性移除函数系列的未支持边界检查。

polars-sql-test/new_sql_doc/functions-index.test

sql-functions/comparison.rst

greatest 和 least 标量函数，使用 ALL、ANY 或 SOME 的量化比较谓词，以及 (a, b) IN ((1, 2)) 这类行值元组 IN 比较。

这些形式没有经过支持验证。Polars SQL 当前在本页记录普通比较运算符、BETWEEN、null 检查、IS DISTINCT FROM、LIKE、标量 IN/NOT IN，以及单列子查询 IN/NOT IN。量化比较语法有部分行为，但完整 SQL 布尔语义尚未验证。

针对保留比较行为的 Polars SQL 测试、针对移除形式的未支持边界检查，以及对不完整量化比较布尔语义的人工验证。

polars-sql-test/new_sql_doc/functions-comparison.test

sql-functions/conditional.rst

try(expression) 条件表达式，它捕获部分运行时错误并返回 NULL。

Polars SQL 在部分上下文中接受 TRY 语法，但其行为未验证为受支持。

针对保留条件表达式的 Polars SQL 测试，以及针对 TRY 的未支持边界检查。

polars-sql-test/new_sql_doc/functions-conditional.test

sql-functions/conversion.rst

try_cast(value AS type)，在转换失败时返回 NULL。

Polars SQL 没有经过验证的 try_cast 语义。对 TRY_CAST('abc' AS INTEGER) 的直接验证显示，它像失败的普通 CAST 一样求值，而不是返回 NULL。

针对保留 CAST 行为的 Polars SQL 测试，以及针对 try_cast 失败行为的人工未支持边界检查。

polars-sql-test/new_sql_doc/functions-conversion.test

sql-functions/conversion.rst

typeof(expr)。

Polars SQL 没有经过验证的标量函数用于返回表达式类型名称。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-conversion.test

sql-functions/math.rst

cbrt、e、pi、pow 别名、rand、random 别名和有界随机数、secure_rand/secure_random、sign、to_base、from_base、truncate 以及 width_bucket。

Polars SQL 没有经过验证的标量函数或兼容函数名映射来支持这些函数。直接 Polars SQL 检查显示，pi 和 rand 的行为不像已验证数值函数。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-math.test

sql-functions/math.rst

概率 CDF 和逆 CDF 函数，包括 beta_cdf、binomial_cdf、normal_cdf、inverse_beta_cdf 和 inverse_normal_cdf。

Polars SQL 没有经过验证的标量函数来支持这些概率分布函数。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-math.test

sql-functions/math.rst

双曲函数和浮点辅助函数 cosh、tanh、infinity、nan、is_finite、is_infinite 和 is_nan。

Polars SQL 没有经过验证的标量函数来支持这些浮点辅助函数。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-math.test

sql-functions/string.rst

bit_length 和 codepoint。

Polars SQL 没有经过验证的兼容名称映射。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-string.test

sql-functions/string.rst

hamming_distance、jarowinkler_similarity、levenshtein_distance、longest_common_prefix 和 word_stem。

Polars SQL 没有经过验证的标量函数来支持这些文本相似度、前缀和词干提取函数。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-string.test

sql-functions/string.rst

Unicode 函数 normalize、to_utf8 和 from_utf8。

Polars SQL 没有经过验证的标量函数来支持这些 Unicode 和二进制转换函数。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-string.test

sql-functions/regexp.rst

regexp_extract_all、regexp_extract、regexp_like 和 regexp_split。

Polars SQL 没有经过验证的标量映射来支持这些正则表达式函数。返回数组的形式也超出了已验证 Polars SQL 标量文档范围。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-regexp.test

sql-functions/regexp.rst

Java Pattern 语法细节和无效模式错误行为。

Polars SQL 正则替换不遵循源 Java Pattern 行为。直接验证显示，无效模式会返回原字符串，而不是产生兼容错误。

Polars SQL 不兼容行为检查。

polars-sql-test/new_sql_doc/functions-regexp.test

sql-functions/datetime.rst

基于 interval 值的日期/时间算术运算符，以及 AT TIME ZONE 运算符。

Polars SQL 没有经过验证的兼容区间算术或带时区时间戳运算符支持。

针对 Polars SQL 未支持语法的检查。

polars-sql-test/new_sql_doc/functions-datetime.test

sql-functions/datetime.rst

last_day_of_month、from_iso8601_timestamp、from_iso8601_date、from_unixtime、to_iso8601、to_milliseconds 和 to_unixtime。

Polars SQL 没有经过验证的标量函数来支持这些日期/时间转换辅助函数。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-datetime.test

sql-functions/datetime.rst

通过 extract 提取字段和别名 QUARTER、WEEK、DAY_OF_WEEK、DOW、DAY_OF_YEAR、DOY、YEAR_OF_WEEK、YOW、TIMEZONE_HOUR、TIMEZONE_MINUTE，以及便捷函数 day_of_month、day_of_week、day_of_year、dow、doy、millisecond、timezone_hour、timezone_minute、week、week_of_year、year_of_week 和 yow。

Polars SQL 只验证兼容支持 YEAR、MONTH、DAY/DAY_OF_MONTH、HOUR、MINUTE、SECOND，以及日期时间页面中保留的便捷函数。

Polars SQL 未支持或不兼容提取检查。

polars-sql-test/new_sql_doc/functions-datetime.test

sql-functions/aggregate.rst

通用聚合 array_agg、bool_and、bool_or、every、checksum、geometric_mean、interval avg、reduce_agg、set_agg 和 set_union。

Polars SQL 只验证支持聚合页面中保留的标量值通用聚合函数。

Polars SQL 保留聚合检查和代表性未支持函数检查。

polars-sql-test/new_sql_doc/functions-aggregate.test

sql-functions/aggregate.rst

返回数组的 Top-N 聚合形式 max(x, n) 和 min(x, n)。

直接 Polars SQL 验证显示，这些形式返回标量 max(x) 和 min(x) 值，而不是兼容的 top-N 数组，因此有意不将其记录为受支持的源文档行为。

Polars SQL 不兼容行为检查。

polars-sql-test/new_sql_doc/functions-aggregate.test

sql-functions/aggregate.rst

Map 聚合函数 histogram、map_agg、map_union、map_union_sum 和 multimap_agg。

Polars SQL 没有经过验证的返回 map 的聚合支持来覆盖这些函数。

针对 Polars SQL 未支持函数的检查。

polars-sql-test/new_sql_doc/functions-aggregate.test

sql-functions/aggregate.rst

统计聚合 entropy、kurtosis 和 skewness。

Polars SQL 没有经过验证的兼容聚合函数来支持这些统计函数。已验证的统计支持仅限于聚合页面中保留的协方差、相关性、回归、方差和标准差函数。

Polars SQL 保留统计聚合检查和未支持函数检查。

polars-sql-test/new_sql_doc/functions-aggregate.test

sql-functions/window.rst

GROUPS 窗口框架。

Polars SQL 不支持 GROUPS 框架。保留的窗口函数页面只记录已验证的 ROWS 和 RANGE 框架。

针对 Polars SQL 未支持窗口框架的检查。

polars-sql-test/new_sql_doc/functions-window.test

language/types.rst

TINYINT 类型。

Polars SQL 没有经过验证的 TINYINT 转换或支持。SMALLINT 可被接受，但以整数类型表示，并单独记录。

针对 Polars SQL 未支持转换的检查。

polars-sql-test/new_sql_doc/language-types.test

language/types.rst

定长 CHAR(x) 填充和比较语义。

Polars SQL 接受 CHAR 作为字符串类型别名，但直接验证 CAST('abc' AS CHAR(7)) 返回 abc，而不是定长填充值。保留的类型页面只将 CHAR 记录为字符串别名。

Polars SQL 不兼容行为检查。

polars-sql-test/new_sql_doc/language-types.test

language/types.rst

TIME WITH TIME ZONE、TIMESTAMP WITH TIME ZONE 和 interval 类型。

在本页中，Polars SQL 只验证支持 DATE、不带时区的 TIME 和不带时区的 TIMESTAMP。时区和 interval 行为未验证为兼容。

针对 Polars SQL 未支持时区/interval 的检查，以及日期时间页面的未支持时区检查。

polars-sql-test/new_sql_doc/language-types.test

language/types.rst

网络、UUID、sketch 和地理空间类型，包括 IPADDRESS、IPPREFIX、UUID、HyperLogLog、P4HyperLogLog、KHyperLogLog、SetDigest、SfmSketch、QDigest、TDigest、KLL Sketch 和地理空间类型。

Polars SQL 没有经过验证的兼容支持来覆盖这些 SQL 专用值类型和 sketch 类型。

针对代表性网络和 UUID 字面量的 Polars SQL 未支持类型检查。

polars-sql-test/new_sql_doc/language-types.test

language/reserved.rst

源保留关键字表以及 SQL:2016/SQL-92 状态列。

Polars SQL 使用自己的解析器语法和保留关键字集合。保留页面列出的是 Polars SQL 解析器保留关键字，而不是源解析器/标准状态表。

Polars SQL 检查带引号保留标识符、拒绝未加引号的保留标识符，以及非保留关键字标识符。

polars-sql-test/new_sql_doc/language-reserved.test

sql/alter-function.rst

用于更改函数 null 调用行为的 ALTER FUNCTION 语句。

Polars SQL 没有经过验证的支持来修改 SQL 函数元数据。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-alter-function.test

sql/alter-schema.rst

ALTER SCHEMA ... RENAME TO。

不支持 schema 重命名。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-alter-schema.test

sql/analyze.rst

连接器专用 ANALYZE ... WITH (...) 属性以及 Hive/Iceberg 分区示例。

在本页中，Polars SQL 只验证支持普通 ANALYZE table_name。连接器专用 analyze 属性以及 catalog/schema 示例不属于 Polars SQL。

Polars SQL 保留普通 ANALYZE 检查。

polars-sql-test/new_sql_doc/sql-analyze.test

sql/commit.rst

COMMIT [ WORK ] 事务控制语句。

Polars SQL 没有经过验证的显式事务控制 SQL 支持。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-commit.test

sql/create-role.rst

CREATE ROLE 角色管理语句。

Polars SQL 没有经过验证的角色管理支持。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-create-role.test

sql/create-table.rst

CREATE TABLE 表/列注释、表和列连接器属性、system.metadata.table_properties、system.metadata.column_properties、LIKE 列复制，以及 PRIMARY KEY 和 UNIQUE 等表或列键约束。

Polars SQL 已验证支持普通列定义、IF NOT EXISTS 和 NOT NULL。直接验证显示，LIKE 建表在 SQL 行为中会失败，PRIMARY KEY 语法不会强制唯一性。连接器属性元数据和注释持久化未验证为兼容源文档行为。

Polars SQL 保留 CREATE TABLE 检查，以及不兼容 PRIMARY KEY 和未支持 LIKE 检查。

polars-sql-test/new_sql_doc/sql-create-table.test

sql/create-vector-index.rst

CREATE VECTOR INDEX.

Polars SQL 不支持向量索引 DDL。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-create-vector-index.test

sql/create-materialized-view.rst

CREATE MATERIALIZED VIEW.

不支持创建物化视图。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-create-materialized-view.test

sql/describe.rst

DESCRIBE table_name，即 SHOW COLUMNS 的别名。

不支持 DESCRIBE 表检查。

针对已有表的 Polars SQL 未支持语句检查。

polars-sql-test/new_sql_doc/sql-describe.test

sql/drop-function.rst

用于用户自定义 SQL 函数或临时函数的 DROP FUNCTION。

Polars SQL 没有经过验证的删除用户自定义 SQL 函数支持。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-drop-function.test

sql/drop-schema.rst

DROP SCHEMA IF EXISTS 缺失 schema 抑制语义。

Polars SQL 可以删除已有 schema，但直接验证显示 IF EXISTS 不会抑制 schema 缺失错误。

Polars SQL 保留 DROP SCHEMA 检查以及不兼容的缺失 schema IF EXISTS 检查。

polars-sql-test/new_sql_doc/sql-drop-schema.test

sql/execute.rst

EXECUTE 预处理语句执行。

不支持预处理语句执行。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-execute.test

sql/explain-analyze.rst

EXPLAIN ANALYZE 运行时计划和算子统计信息。

Polars SQL 不支持 EXPLAIN ANALYZE 执行语义或算子统计输出。

Polars SQL 未支持/不兼容语句检查。

polars-sql-test/new_sql_doc/sql-explain-analyze.test

sql/merge.rst

MERGE 条件插入/更新/删除语句。

不支持 MERGE。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-merge.test

sql/refresh-materialized-view.rst

REFRESH MATERIALIZED VIEW。

不支持刷新物化视图。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-refresh-materialized-view.test

sql/revoke.rst and sql/revoke-roles.rst

权限回收和角色回收。

Polars SQL 没有经过验证的权限或角色管理 SQL 支持。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-revoke.test and polars-sql-test/new_sql_doc/sql-revoke-roles.test

sql/select.rst

WITH RECURSIVE.

Polars SQL 会将递归 WITH 查询报告为不支持。

针对 Polars SQL 未支持查询的检查。

polars-sql-test/new_sql_doc/sql-select.test

sql/select.rst

UNNEST 和 WITH ORDINALITY。

Polars SQL 没有经过验证的数组或 map 展开支持。

针对 Polars SQL 未支持查询的检查。

polars-sql-test/new_sql_doc/sql-select.test

sql/select.rst

INTERSECT ALL 和 EXCEPT ALL 多重集语义。

Polars SQL 验证仅覆盖 INTERSECT 和 EXCEPT 的去重集合语义。多重集语义未记录为受支持。

Polars SQL 保留去重集合运算检查。

polars-sql-test/new_sql_doc/sql-select.test

sql/set-session.rst

SET SESSION 会话属性赋值语法。

Polars SQL 没有经过验证的会话属性控制语句支持。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-set-session.test

sql/start-transaction.rst

START TRANSACTION 事务控制语法。

Polars SQL 没有经过验证的显式事务控制 SQL 支持。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-start-transaction.test

sql/use.rst

USE catalog/schema 会话选择。

不支持 USE。

针对 Polars SQL 未支持语句的检查。

polars-sql-test/new_sql_doc/sql-use.test