AWS Clean Rooms 差异隐私的 SQL 功能

AWS Clean Rooms 差异隐私使用通用查询结构来支持复杂的 SQL 查询。根据此结构对自定义分析模板进行验证，以确保它们可以在受差别隐私保护的表上运行。下表指示支持哪些函数。请参阅查询结构和语法了解更多信息。

类别	Spark 分析引擎支持的 SQL 结构	SQL 分析引擎支持的 AWS Clean Rooms SQL 结构	常用表表达式 (CTEs)	最终 SELECT 子句
聚合函数	ANY_VALUE 函数 APPROXIMATE PERCENTILE_DISC 函数 AVG 函数 COUNT 和 COUNT DISTINCT 函数 MAX 函数 MEDIAN 函数 MIN 函数 PERCENTILE_CONT 函数 STDDEV_SAMP 和 STDDEV_POP 函数 SUM 和 SUM DISTINCT 函数 VAR_SAMP 和 VAR_POP 函数	ANY_VALUE 函数 APPROXIMATE PERCENTILE_DISC 函数 AVG 函数 COUNT 和 COUNT DISTINCT 函数 LISTAGG 函数 MAX 函数 MEDIAN 函数 MIN 函数 PERCENTILE_CONT 函数 STDDEV_SAMP 和 STDDEV_POP 函数 SUM 和 SUM DISTINCT 函数 VAR_SAMP 和 VAR_POP 函数	支持这样的条件： CTEs 使用受差异隐私保护的表必须生成具有用户级记录的数据。您应该 CTEs 使用`SELECT userIdentifierColumn...'格式编写 SELECT 表达式。	支持的聚合：AVG、COUNT、COUNT DISTINCT、STDDEV 和 SUM。
CTEs	WITH 子句、WITH 子句子查询	WITH 子句、WITH 子句子查询	支持这样的条件： CTEs 使用受差异隐私保护的表必须生成具有用户级记录的数据。您应该 CTEs 使用`SELECT userIdentifierColumn...'格式编写 SELECT 表达式。	不适用
子查询	SELECT HAVING JOIN JOIN 条件 FROM WHERE	SELECT HAVING JOIN JOIN 条件 FROM WHERE	在这些结构中，你可以有任何不引用差异隐私关系的子查询。您只能在 FROM 和 JOIN 子句中使用任何引用差异隐私关系的子查询。
联接条款	INNER JOIN LEFT JOIN 左半连接左边反连接 RIGHT JOIN FULL JOIN [JOIN] OR 运算符 CROSS JOIN	INNER JOIN LEFT JOIN RIGHT JOIN FULL JOIN [JOIN] OR 运算符 CROSS JOIN	支持的条件是，仅支持对用户标识符列进行等值联接的 JOIN 函数；在查询两个或更多开启了差别隐私的表时，必须使用这些函数。确保必需的等值联接条件是正确的。确认表所有者在所有表中配置了相同的用户标识符列，以便用户的定义在表之间保持一致。在合并两个或更多开启了差别隐私的关系时，不支持 CROSS JOIN 函数。
集合运算符	UNION、UNION ALL、INTERSECT、除外 \| 减号（这些是同义词）	UNION、UNION ALL、INTERSECT、除外 \| 减号（这些是同义词）	全部支持	不支持
窗口函数	聚合函数 AVG 窗口函数 COUNT 窗口函数 CUME_DIST 开窗函数 DENSE_RANK 窗口函数 FIRST_VALUE 窗口函数 LAG 窗口函数 LAST_VALUE 窗口函数 LEAD 窗口函数 MAX 窗口函数 MEDIAN 窗口函数 MIN 窗口函数 NTH_VALUE 窗口函数 STDDEV_SAMP 和 STDDEV_POP 窗口函数（STDDEV_SAMP 和 STDDEV 是同义词） SUM 窗口函数 VAR_SAMP 和 VAR_POP 窗口函数（VAR_SAMP 和 VARIANCE 是同义词）排名函数 DENSE_RANK 窗口函数 NTILE 窗口函数 PERCENT_RANK 开窗函数 RANK 窗口函数 ROW_NUMBER 窗口函数	聚合函数 AVG 窗口函数 COUNT 窗口函数 CUME_DIST 开窗函数 DENSE_RANK 窗口函数 FIRST_VALUE 窗口函数 LAG 窗口函数 LAST_VALUE 窗口函数 LEAD 窗口函数 MAX 窗口函数 MEDIAN 窗口函数 MIN 窗口函数 NTH_VALUE 窗口函数 RATIO_TO_REPORT 开窗函数 STDDEV_SAMP 和 STDDEV_POP 窗口函数（STDDEV_SAMP 和 STDDEV 是同义词） SUM 窗口函数 VAR_SAMP 和 VAR_POP 窗口函数（VAR_SAMP 和 VARIANCE 是同义词）排名函数 DENSE_RANK 窗口函数 NTILE 窗口函数 PERCENT_RANK 开窗函数 RANK 窗口函数 ROW_NUMBER 窗口函数	在查询开启差异隐私的关系时，窗口函数的分区子句中的用户标识符列是必填的，条件是所有这些都支持。	不支持
条件表达式	CASE 条件表达式 COALESCE 表达式 GREATEST 和 LEAST 函数 NVL 和 COALESCE 函数 NVL2 函数 NULLIF 函数	CASE 条件表达式 COALESCE 表达式 GREATEST 和 LEAST 函数 NVL 和 COALESCE 函数 NVL2 函数 NULLIF 函数	全部支持	全部支持
Conditions	比较条件逻辑条件模式匹配条件 BETWEEN 范围条件 Null 条件	比较条件逻辑条件模式匹配条件 BETWEEN 范围条件 Null 条件	`EXISTS`并且`IN`无法使用，因为它们需要子查询。支持所有其他内容。	全部支持
日期时间函数	事务中的日期和时间函数串联运算符 ADD_MONTHS 函数 CONVERT_TIMEZONE 函数 CURRENT_DATE 函数 DATEADD 函数 DATEDIFF 函数 DATE_PART 函数 DATE_TRUNC 函数 EXTRACT 函数 TO_TIMESTAMP 函数日期或时间戳函数的日期部分	事务中的日期和时间函数串联运算符 ADD_MONTHS 函数 CONVERT_TIMEZONE 函数 CURRENT_DATE 函数 DATEADD 函数 DATEDIFF 函数 DATE_PART 函数 DATE_TRUNC 函数 EXTRACT 函数 GETDATE 函数 TIMEOFDAY 函数 TO_TIMESTAMP 函数日期或时间戳函数的日期部分	全部支持	全部支持
字符串函数	\|\|（串联）运算符 BTRIM 函数 CHAR_LENGTH 函数 CHARACTER_LENGTH 函数 CONCAT 函数 LEFT 和 RIGHT 函数 LEN 函数 LENGTH 函数 LOWER 函数 LPAD 和 RPAD 函数 LTRIM 函数 POSITION 函数 REGEXP_COUNT 函数 REGEXP_INSTR 函数 REGEXP_REPLACE 函数 REGEXP_SUBSTR 函数 REPEAT 函数 REPLACE 函数 REVERSE 函数 RTRIM 函数 SPLIT_PART 函数 SUBSTRING 函数 TRANSLATE 函数 TRIM 函数 UPPER 函数	\|\|（串联）运算符 BTRIM 函数 CHAR_LENGTH 函数 CHARACTER_LENGTH 函数 CONCAT 函数 LEFT 和 RIGHT 函数 LEN 函数 LENGTH 函数 LOWER 函数 LPAD 和 RPAD 函数 LTRIM 函数 POSITION 函数 REGEXP_COUNT 函数 REGEXP_INSTR 函数 REGEXP_REPLACE 函数 REGEXP_SUBSTR 函数 REPEAT 函数 REPLACE 函数 REPLICATE 函数 REVERSE 函数 RTRIM 函数 SOUNDEX 函数 SPLIT_PART 函数 STRPOS 函数 SUBSTRING 函数 TEXTLEN 函数 TRANSLATE 函数 TRIM 函数 UPPER 函数	全部支持	全部支持
数据类型格式设置函数	CAST 函数 TO_CHAR TO_DATE 函数 TO_NUMBER 日期时间格式字符串数字格式字符串	CAST 函数 TO_CHAR TO_DATE 函数 TO_NUMBER 日期时间格式字符串数字格式字符串	全部支持	全部支持
哈希函数	AES_加密 AES_DECRYPT ENCODE DECODE MD5 函数 SHA1 函数 SHA2 函数 XX_ HASH64	MD5 函数 SHA 函数 SHA1 函数 SHA2 函数 MURMUR3_32_HASH	全部支持	全部支持
数学运算符符号	+、-、*、/、% 和 @	+、-、*、/、% 和 @	全部支持	全部支持
数学函数	ABS 函数 ACOS 函数 ASIN 函数 ATAN 函数 ATAN2 函数 CBRT 函数 CEILING（或 CEIL）函数 COS 函数 COT 函数 DEGREES 函数 LTRIM 函数 EXP 函数 FLOOR 函数 LN 函数 LOG 函数 MOD 函数 PI 函数 POWER 函数 RADIANS 函数 RANDOM 函数 ROUND 函数 SIGN 函数 SIN 函数 SQRT 函数 TRUNC 函数	ABS 函数 ACOS 函数 ASIN 函数 ATAN 函数 ATAN2 函数 CBRT 函数 CEILING（或 CEIL）函数 COS 函数 COT 函数 DEGREES 函数 DEXP 函数 LTRIM 函数 DLOG1 函数 DLOG10 函数 EXP 函数 FLOOR 函数 LN 函数 LOG 函数 MOD 函数 PI 函数 POWER 函数 RADIANS 函数 RANDOM 函数 ROUND 函数 SIGN 函数 SIN 函数 SQRT 函数 TRUNC 函数	全部支持	全部支持
VARBYTE 函数	UNHEX， UNBASE64 十六进制 HLL_SKETCH_AGG， HLL_SKETCH_ESTIMATE HLL_UNION HLL_UNION_AGG	FROM_HEX 函数 FROM_VARBYTE 函数 TO_HEX 函数 TO_VARBYTE 函数	全部支持	全部支持
JSON	TO_JSON GET_JSON_OBJECT	CAN_JSON_PARSE 函数 JSON_EXTRACT_ARRAY_ELEMENT_TEXT 函数 JSON_EXTRACT_PATH_TEXT 函数 JSON_PARSE 函数 JSON_SERIALIZE 函数 JSON_SERALIZE_TO_VARBYTE 函数	全部支持	全部支持
数组函数	数组_包含数组_DISTINCT 数组_除外数组_相交 ARRAY_JOIN 数组_删除数组_排序 ARRAY_UNION	数组函数 array_concat 函数 array_flatten 函数 get_array_length 函数 split_to_array 函数子数组函数	不支持	不支持
扩展分组依据	分组集、汇总、立方体	分组集、汇总、立方体	不支持	不支持
排序操作	ORDER BY	ORDER BY	支持 ORDER BY 子句，条件是只有在开启差分隐私的情况下查询表时，窗口函数的分区子句才支持 ORDER BY 子句。	支持
行数限制	LIMIT、OFFSET	LIMIT、OFFSET	不支持 CTEs 使用受差异隐私保护的表	全部支持
表和列别名			支持	支持
聚合函数上的数学函数			支持	支持
聚合函数中的标量函数			支持	支持

不支持的 SQL 构造的常见替代方案

类别	SQL 构造	或者
窗口函数	LISTAGG PERCENTILE_CONT PERCENTILE_DISC	您可以将等效的聚合函数与 GROUP BY 一起使用。
数学运算符符号	$column \|\|/ 2 $column \|/ 2 $column ^ 2	CBRT SQRT POWER($column, 2)
标量函数	SYSDATE $column::integer convert(type, $column)	CURRENT_DATE CAST $column AS integer CAST $column AS type
文本	间隔 '1 秒'	间隔 '1' 秒
行限制	TOP n	限制 n
联接	USING NATURAL	ON 子句应明确包含连接标准。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

差别隐私策略

SQL 查询技巧和示例