文档中心

日志服务

请输入

SQL 语法

JOIN 子句

JOIN 子句用于连表查询。日志服务支持跨日志项目查询、日志主题和 MySQL 外部数据源的联合查询。本文档介绍 JOIN 子句的基本的语法与典型示例。

Demo 中心

日志服务 Demo 中心提供了 SQL 语法 Demo，方便您快速体验功能。单击 SQL语法案例立即体验。

注意

Demo 中心的数据为演示数据，请勿用于生产环境。

语法格式

JOIN 子句的语法格式如下。

参数说明如下：

参数	说明
Key	日志字段或表达式等。设置为字段时，格式为 table.key，即表别名.日志字段名，表示某个日志主题或数据库表中的某个日志字段。
JOIN_TYPE	JOIN 方式，日志服务支持的 JOIN 方式请参考下表。
table	日志主题或外部数据源的表。如果是日志主题，则需指定日志项目名称，例如 project1.table1。位于 JOIN 关键字之前的 table 必须为日志主题；位于 JOIN 关键字之后的 table，可以为日志主题或外部数据源的表。例如 table1 必须为日志主题，table2 可以是日志主题或外部数据源的表。当名称中包含-/$*&%#@等特殊字符时，需使用双引号 "" 包裹，例如 "test-log.open_api"。
alias	表别名。
JOIN_CONDITION	连表查询的条件，应指定 JOIN 前后的主体通过某个字段进行关联。例如 alias1.key1=alias2.key2。说明 JOIN_CONDITION 处需要指定表名时，应填写 AS 指定的列别名，请勿填写原始表名。

JOIN 方式（JOIN_TYPE）说明如下：

JOIN 方式	说明
LEFT JOIN	无论右表（table2）中是否存在匹配成功的数据，均只从左表（table1）返回所有 SELECT 结果。
RIGHT JOIN	无论左表（table1）中是否存在匹配成功的数据，均只从右表（table2）返回所有 SELECT 结果。
[INNER] JOIN	返回两表的交集结果。其中，INNER 可省略。
FULL JOIN	返回两表的并集结果。

示例

示例 1：跨日志主题查询

示例 2：跨日志项目查询

分析活跃用户的年龄分布。在 project1 日志项目的 topic1 日志主题中统计访问量，并根据 userid/uid 在 project2 日志项目的 topic2 日志主题中统计访问来源的年龄分布。

示例 3：日志主题和 MySQL 联合查询

分析活跃用户的年龄分布。在名为 topic1 的日志主题和名为 tls_external_store 的外部数据源中进行联合查询，两个数据源通过 userid 和 uid 字段关联。在 topic1 日志主题中统计访问量，并根据 userid/uid 在 tls_external_store 中统计访问来源的年龄分布。

最近更新时间：2026.08.28 15:12:48

这个页面对您有帮助吗？

有用

无用