华为云用户手册

语法格式 create table postgresCdcSource ( attr_name attr_type (',' attr_name attr_type)* (','PRIMARY KEY (attr_name, ...) NOT ENFORCED) ) with ( 'connector' = 'postgres-cdc', 'hostname' = 'PostgresHostname', 'username' = 'PostgresUsername', 'password' = 'PostgresPassword', 'database-name' = 'PostgresDatabaseName', 'schema-name' = 'PostgresSchemaName', 'table-name' = 'PostgresTableName' );

示例 1 2 3 4 5 6 create table 1_datasource_mongo.test_mongo(id string, name string, age int) using mongo options( 'url' = '192.168.4.62:8635,192.168.5.134:8635/test?authSource=admin', 'database' = 'test', 'collection' = 'test', 'passwdauth' = 'xxx', 'encryption' = 'true');

语法格式 1 2 3 4 5 6 7 8 9 10 CREATE TABLE [IF NOT EXISTS] TABLE_NAME( FIELDNAME1 FIELDTYPE1, FIELDNAME2 FIELDTYPE2) USING MONGO OPTIONS ( 'url'='IP:PORT[,IP:PORT]/[DATABASE][.COLLECTION][AUTH_PROPERTIES]', 'database'='xx', 'collection'='xx', 'passwdauth' = 'xxx', 'encryption' = 'true' );

注意事项 通过配置“spark.sql.shuffle.partitions”参数可以设置非 DLI 表在OBS桶中插入的文件个数，同时，为了避免数据倾斜，在INSERT语句后可加上“distribute by rand()”，可以增加处理作业的并发量。例如： insert into table table_target select * from table_source distribute by cast(rand() * N as int); 配置项为OPTIONS('DELIMITER'=',')时，可以指定分隔符，默认值为“,”。 对于 CS V数据，支持如下所述分隔符： 制表符tab，例如：'DELIMITER'='\t'。 任意的二进制字符，例如：'DELIMITER'='\u0001(^A)'。 单引号（'），单引号必须在双引号（" "）内。例如：'DELIMITER'= "'"。 DLI表还支持\001（^A）和\017（^Q），例如：'DELIMITER'='\001(^A)'，'DELIMITER'='\017(^Q)'。

参数说明 表1 参数说明 参数 是否必选 默认值 数据类型 说明 connector 是 无 String connector类型，需配置为'gaussdb'。 url 是 无 String jdbc连接地址。“url”参数中的ip地址请使用DWS的内网地址。 使用gsjdbc4驱动连接时，格式为：jdbc:postgresql://${ip}:${port}/${dbName} 。 使用gsjdbc200驱动连接时，格式为：jdbc:gaussdb://${ip}:${port}/${dbName}。 table-name 是 无 String 操作的DWS表名。如果该DWS表在某schema下，则具体可以参考如果该DWS表在某schema下的说明。 driver 否 org.postgresql.Driver String jdbc连接驱动，默认为: org.postgresql.Driver。 使用gsjdbc4驱动连接时，加载的数据库驱动类为：org.postgresql.Driver。 使用gsjdbc200驱动连接时，加载的数据库驱动类为：com.huawei.gauss200.jdbc.Driver。 username 否 无 String DWS数据库认证用户名，需要和'password'参数一起配置。 password 否 无 String DWS数据库认证密码，需要和'username'参数一起配置。 scan.partition.column 否 无 String 用于对输入进行分区的列名。 注意：该参数与scan.partition.lower-bound、scan.partition.upper-bound、 scan.partition.num参数必须同时配置或者同时都不配置。 scan.partition.lower-bound 否 无 Integer 第一个分区的最小值。 与scan.partition.column、scan.partition.upper-bound、 scan.partition.num必须同时配置或者同时都不配置。 scan.partition.upper-bound 否 无 Integer 最后一个分区的最大值。 与scan.partition.column、scan.partition.lower-bound、 scan.partition.num必须同时配置或者同时都不配置。 scan.partition.num 否 无 Integer 分区的个数。 与scan.partition.column、scan.partition.upper-bound、 scan.partition.upper-bound必须同时配置或者同时都不配置。 scan.fetch-size 否 0 Integer 每次从数据库拉取数据的行数。默认值为0，表示不限制。 pwd_auth_name 否 无 String DLI侧创建的Password类型的跨源认证名称。 使用跨源认证则无需在作业中配置账号和密码。

常见问题 Q：作业运行失败，运行日志中有如下报错信息，应该怎么解决？ java.io.IOException: unable to open JDBC writer ... Caused by: org.postgresql.util.PSQLException: The connection attempt failed. ... Caused by: java.net.SocketTimeoutException: connect timed out A：应考虑是跨源没有绑定，或者跨源没有绑定成功。 参考增强型跨源连接章节，重新配置跨源。参考DLI跨源连接DWS失败进行问题排查。

前提条件 请务必确保您的账户下已在 数据仓库 服务（DWS）里创建了DWS集群。 如何创建DWS集群，请参考《数据仓库服务管理指南》中“创建集群”章节。 请确保已创建DWS数据库表。 该场景作业需要运行在DLI的独享队列上，因此要与DWS集群建立增强型跨源连接，且用户可以根据实际所需设置相应安全组规则。 如何建立增强型跨源连接，请参考《 数据湖探索 用户指南》中增强型跨源连接章节。 如何设置安全组规则，请参见《虚拟私有云用户指南》中“安全组”章节。 Flink跨源开发场景中直接配置跨源认证信息存在密码泄露的风险，优先推荐您使用DLI提供的跨源认证。 跨源认证简介及操作方法请参考跨源认证简介。

功能描述 DLI将Flink作业从数据仓库服务（DWS）中读取数据。DWS数据库内核兼容PostgreSQL，PostgreSQL数据库可存储更加复杂类型的数据，支持空间信息服务、多版本并发控制（MVCC）、高并发，适用场景包括位置应用、金融保险、互联网电商等。 数据仓库服务（Data Warehouse Service，简称DWS）是一种基于基础架构和平台的在线数据处理数据库，为用户提供海量数据挖掘和分析服务。DWS的更多信息，请参见《数据仓库服务管理指南》。

语法格式 1 2 3 4 5 6 7 8 9 10 11 12 13 create table dwsSource ( attr_name attr_type (',' attr_name attr_type)* (','PRIMARY KEY (attr_name, ...) NOT ENFORCED) (',' watermark for rowtime_column_name as watermark-strategy_expression) ) with ( 'connector' = 'gaussdb', 'url' = '', 'table-name' = '', 'username' = '', 'password' = '' );

关键字 表1 CREATE TABLE参数描述 参数 描述 USING [CLOUDTABLE | HBASE] 指定hbase datasource，"CLOUDTABLE"或"HBASE"二选一，大小写不敏感。 ZKHost HBase集群的ZK连接地址。 获取ZK连接地址需要先创建跨源连接，管理控制台操作请参考经典型跨源连接和增强型跨源连接。 访问CloudTable集群，填写ZK连接地址（内网）。 访问 MRS 集群，填写ZK所在节点IP与ZK对外端口，格式为："ZK_IP1:ZK_PORT1,ZK_IP2:ZK_PORT2"。 说明： 访问MRS集群，只支持创建增强型跨源连接并且需要配置主机信息，管理控制台操作请参考增强型跨源连接，相关API信息请参考创建增强型跨源连接。 TableName 指定在HBase集群中已创建的表名。 RowKey 指定作为rowkey的dli关联表字段，支持单rowkey与组合rowkey。单rowkey支持数值与String类型，不需要指定长度。组合rowkey仅支持String类型定长数据，格式为：属性名1:长度,属性名2:长度。 Cols 通过逗号分隔的DLI表字段与HBase表的列之间的对应关系。其中，冒号前面放置DLI表字段，冒号后面放置HBase表信息，用‘.’分隔HBase表的列族与列名。

注意事项 若所要创建的表已经存在将报错，可以通过添加IF NOT EXISTS参数跳过该错误。 OPTIONS中的所有参数是必选的，参数名称大小写不敏感，但参数值大小写敏感。 OPTIONS中引号内的值前后不能带空格，空格也会被当做有效值。 表名及列名的描述仅支持字符串常量。 创建表时要说明列名及对应的数据类型，目前支持的数据类型为：boolean、short、int、long、float、double和string。 作为RowKey的字段（如上述语法格式中的ATTR1），其值不能为null，长度要大于0，小于或等于32767。 Cols与RowKey中的字段加起来的数量必须与DLI表的字段保持一致，即表中所有的字段都到对应到Cols和RowKey中，但是顺序可以任意。 组合Rowkey只支持String类型，在使用组合Rowkey时，每个属性后面必须带上长度。当Rowkey指定的字段只有一个的时候，该字段的类型可以是支持的所有数据类型，并且不需要填写长度。 在组合Rowkey的场景中 插入Rowkey数据时，如果某个属性的实际数据的长度比属性作为Rowkey时指定的长度要短，则会在数据后面补'\0'字符；如果某个属性的实际数据的长度比属性作为Rowkey时指定的长度要长，则会在实际插入HBase的时候进行截断。 读取HBase上的Rowkey数据时，如果某个属性的实际数据的长度比属性作为Rowkey时指定的长度要短，则会抛出异常（OutofBoundException）；如果某个属性的实际数据的长度比属性作为Rowkey时指定的长度要长，则会在读取时进行截断。

示例 1 2 3 4 5 6 7 8 9 CREATE TABLE test_hbase( ATTR1 int, ATTR2 int, ATTR3 string) using hbase OPTIONS ( 'ZKHost'='to-hbase-1174405101-CE1bDm5B.datasource.com:2181', 'TableName'='HBASE_TABLE', 'RowKey'='ATTR1', 'Cols'='ATTR2:CF1.C1, ATTR3:CF1.C2');

语法格式 单个RowKey 1 2 3 4 5 6 7 8 9 CREATE TABLE [IF NOT EXISTS] TABLE_NAME ( ATTR1 TYPE, ATTR2 TYPE, ATTR3 TYPE) USING [CLOUDTABLE | HBASE] OPTIONS ( 'ZKHost'='xx', 'TableName'='TABLE_IN_HBASE', 'RowKey'='ATTR1', 'Cols'='ATTR2:CF1.C1, ATTR3:CF1.C2'); 组合RowKey 1 2 3 4 5 6 7 8 9 CREATE TABLE [IF NOT EXISTS] TABLE_NAME ( ATTR1 String, ATTR2 String, ATTR3 TYPE) USING [CLOUDTABLE | HBASE] OPTIONS ( 'ZKHost'='xx', 'TableName'='TABLE_IN_HBASE', 'RowKey'='ATTR1:2, ATTR2:10', 'Cols'='ATTR2:CF1.C1, ATTR3:CF1.C2'

参数说明 表1 参数说明 参数 是否必选 默认值 类型 说明 connector 是 无 String 指定要使用的连接器，这里是'gaussdb' url 是 无 String jdbc连接地址 。 使用gsjdbc4驱动连接时，格式为：jdbc:postgresql://${ip}:${port}/${dbName} 。 使用gsjdbc200驱动连接时，格式为：jdbc:gaussdb://${ip}:${port}/${dbName}。 table-name 是 无 String 操作的表名。如果该DWS表在某schema下，则格式为：'schema\".\"具体表名'，具体可以参考常见问题说明。 driver 否 org.postgresql.Driver String jdbc连接驱动，默认为: org.postgresql.Driver。 使用gsjdbc4驱动连接时，加载的数据库驱动类为：org.postgresql.Driver。 使用gsjdbc200驱动连接时，加载的数据库驱动类为：com.huawei.gauss200.jdbc.Driver。 username 否 无 String DWS数据库认证用户名，需要和'password'一起配置 password 否 无 String DWS数据库认证密码，需要和'username'一起配置 write.mode 否 无 String 数据写入模式，支持: copy, insert以及upsert三种。默认值为upsert。 该参数与'primary key'配合使用。 未配置'primary key'时，支持copy及insert两种模式追加写入。 配置'primary key'，支持copy、upsert以及insert三种模式更新写入。 注意：由于dws不支持更新分布列，因而配置的更新主键必须包含dws表中定义的所有分布列。 sink.buffer-flush.max-rows 否 100 Integer 每次写入请求缓存的最大行数。 它能提升写入数据的性能，但是也可能增加延迟。 设置为 "0" 关闭此选项。 sink.buffer-flush.interval 否 1s Duration 刷新缓存的间隔，在这段时间内以异步线程刷新数据。 它能提升写入数据库的性能，但是也可能增加延迟。 设置为 "0" 关闭此选项。 注意："sink.buffer-flush.max-size" 和 "sink.buffer-flush.max-rows" 同时设置为 "0"，并设置刷新缓存的间隔，则以完整的异步处理方式刷新缓存。 格式为：{length value}{time unit label}，如123ms, 321s，支持的时间单位包括: d,h,min,s,ms等，默认为ms。 sink.max-retries 否 3 Integer 写入最大重试次数。 write.escape-string-value 否 false Boolean 是否对string类型值进行转义。该参数仅用于write.mode为copy模式下。 pwd_auth_name 否 无 String DLI侧创建的Password类型的跨源认证名称。 使用跨源认证则无需在作业中配置置账号和密码。

示例 该示例是从kafka数据源中读取数据，并以insert模式写入DWS结果表中，其具体步骤如下： 参考增强型跨源连接，在DLI上根据DWS和Kafka所在的虚拟私有云和子网分别创建相应的增强型跨源连接，并绑定所要使用的Flink弹性资源池。 设置DWS和Kafka的安全组，添加入向规则使其对Flink的队列网段放通。参考测试地址连通性分别根据DWS和Kafka的地址测试队列连通性。若能连通，则表示跨源已经绑定成功，否则表示未成功。 连接DWS数据库，在DWS中创建相应的表，表名为dws_order，SQL语句参考如下： create table public.dws_order( order_id VARCHAR, order_channel VARCHAR, order_time VARCHAR, pay_amount FLOAT8, real_pay FLOAT8, pay_time VARCHAR, user_id VARCHAR, user_name VARCHAR, area_id VARCHAR); 参考创建Flink OpenSource作业，创建flink opensource sql作业，输入以下作业运行脚本，提交运行作业。该作业脚本将Kafka作业数据源，将DWS作为结果表。 注意：创建作业时，在作业编辑界面的“运行参数”处，“Flink版本”选择“1.12”，勾选“保存作业日志”并设置保存作业日志的OBS桶，方便后续查看作业日志。如下脚本中的加粗参数请根据实际环境修改。 CREATE TABLE kafkaSource ( order_id string, order_channel string, order_time string, pay_amount double, real_pay double, pay_time string, user_id string, user_name string, area_id string ) WITH ( 'connector' = 'kafka', 'topic' = 'KafkaTopic', 'properties.bootstrap.servers' = 'KafkaAddress1:KafkaPort,KafkaAddress2:KafkaPort', 'properties.group.id' = 'GroupId', 'scan.startup.mode' = 'latest-offset', 'format' = 'json' ); CREATE TABLE dwsSink ( order_id string, order_channel string, order_time string, pay_amount double, real_pay double, pay_time string, user_id string, user_name string, area_id string ) WITH ( 'connector' = 'gaussdb', 'url' = 'jdbc:postgresql://DWSAddress:DWSPort/DWSdbName', 'table-name' = 'dws_order', 'driver' = 'org.postgresql.Driver', 'username' = 'DWSUserName', 'password' = 'DWSPassword', 'write.mode' = 'insert' ); insert into dwsSink select * from kafkaSource; 连接Kafka集群，向Kafka中输入以下测试数据。 {"order_id":"202103241000000001", "order_channel":"webShop", "order_time":"2021-03-24 10:00:00", "pay_amount":"100.00", "real_pay":"100.00", "pay_time":"2021-03-24 10:02:03", "user_id":"0001", "user_name":"Alice", "area_id":"330106"} 从DWS中使用如下SQL语句查看数据结果。 select * from dws_order 数据结果参考如下： 202103241000000001 webShop 2021-03-24 10:00:00 100.0 100.0 2021-03-24 10:02:03 0001 Alice 330106

语法格式 DWS结果表中不允许指定所有属性为PRIMARY KEY。 1 2 3 4 5 6 7 8 9 10 11 12 13 create table dwsSink ( attr_name attr_type (',' attr_name attr_type)* (','PRIMARY KEY (attr_name, ...) NOT ENFORCED) ) with ( 'connector' = 'gaussdb', 'url' = '', 'table-name' = '', 'driver' = '', 'username' = '', 'password' = '' );

功能描述 DLI将Flink作业的输出数据输出到数据仓库服务（DWS）中。DWS数据库内核兼容PostgreSQL，PostgreSQL数据库可存储更加复杂类型的数据，支持空间信息服务、多版本并发控制（MVCC）、高并发，适用场景包括位置应用、金融保险、互联网电商等。 数据仓库服务（Data Warehouse Service，简称DWS）是一种基于基础架构和平台的在线数据处理数据库，为用户提供海量数据挖掘和分析服务。DWS的更多信息，请参见《数据仓库服务管理指南》。

前提条件 创建Flink OpenSource SQL作业时，在作业编辑界面的“运行参数”处，“Flink版本”需要选择“1.12”，勾选“保存作业日志”并设置保存作业日志的OBS桶，方便后续查看作业日志。 请务必确保您的账户下已在数据仓库服务（DWS）里创建了DWS集群。如何创建DWS集群，请参考《数据仓库服务管理指南》中“创建集群”章节。 请确保已创建DWS数据库表。 该场景作业需要运行在DLI的独享队列上，因此要与DWS集群建立增强型跨源连接，且用户可以根据实际所需设置相应安全组规则。 如何建立增强型跨源连接，请参考《 数据湖 探索用户指南》中增强型跨源连接章节。 如何设置安全组规则，请参见《虚拟私有云用户指南》中“安全组”章节。 Flink跨源开发场景中直接配置跨源认证信息存在密码泄露的风险，优先推荐您使用DLI提供的跨源认证。 跨源认证简介及操作方法请参考跨源认证简介。

注意事项 若需要使用upsert模式，则必须在DWS结果表和该结果表连接的DWS表都定义主键。 若DWS在不同的schema中存在相同名称的表，则在flink opensource sql中需要指定相应的schema。 提交Flink作业前，建议勾选“保存作业日志”参数，在OBS桶选项中选择日志保存的位置，方便后续作业提交失败或运行异常时，查看日志并分析问题原因。 使用gsjdbc4驱动连接时，加载的数据库驱动类为：org.postgresql.Driver。该驱动为默认，创建表时可以不填该驱动参数。 例如，使用gsjdbc4驱动连接、upsert模式写入数据到DWS中。 1 2 3 4 5 6 7 8 9 10 11 12 13 create table dwsSink( car_id STRING, car_owner STRING, car_brand STRING, car_speed INT ) with ( 'connector' = 'gaussdb', 'url' = 'jdbc:postgresql://DwsAddress:DwsPort/DwsDatabase', 'table-name' = 'car_info', 'username' = 'DwsUserName', 'password' = 'DwsPasswrod', 'write.mode' = 'upsert' ); 使用gsjdbc200驱动连接时，加载的数据库驱动类为：com.huawei.gauss200.jdbc.Driver。 当DWS表test在名为ads_game_sdk_base的schema下时，可以参考如下样例创建DWS结果表。 create table dwsSink( car_id STRING, car_owner STRING, car_brand STRING, car_speed INT ) with ( 'connector' = 'gaussdb', 'table-name' = 'ads_game_sdk_base\".\"test', 'driver' = 'com.huawei.gauss200.jdbc.Driver', 'url' = 'jdbc:gaussdb://DwsAddress:DwsPort/DwsDatabase', 'username' = 'DwsUserName', 'password' = 'DwsPasswrod', 'write.mode' = 'upsert' );

样式 尺寸位置 图表尺寸：设置图表的宽和高。单位为px。 图表位置：设置图表在画布中的位置。单位为px。 图1 尺寸位置-世界地图 添加子组件 在世界地图中可添加的子组件有： 地图飞线：配置方法和基础平面地图中的地图飞线相似，请参考地图飞线。 地图散点：配置方法和基础平面地图中的地图散点相似，请参考地图散点。 进阶版散点层：配置方法和基础平面地图中的进阶版散点层相似，请参考进阶版散点层。 基础平面地图中的进阶版散点层支持交互功能，但是，在世界地图中，进阶版散点层不支持交互功能。 地图热力层：配置方法和基础平面地图中的地图热力层相似，请参考地图热力层。 地图子组件的相关操作如下： 添加子组件 在“样式”配置栏，单击“添加子组件”按钮，然后在弹出菜单中选择一个子组件，即可将该子组件添加到地图组件中。子组件添加完成后，在“添加子组件”按钮下方会显示所添加的子组件名称，例如“地图飞线”。 图2 添加子组件 编辑子组件 单击子组件名称就可以编辑子组件。 删除子组件 单击子组件名称后面的按钮，可以删除该子组件。 全局样式 地图中心：设置地图中心在图层中的位置。 地图缩放：设置地图中心在图层中的缩放比例。 图3 全局样式-世界地图 填充设置 填充颜色：设置填充的颜色和透明度。 边线选择：设置边线的颜色和宽度。 图4 填充设置-世界地图 视觉映射 显示/隐藏视觉映射：单击“标签”右侧的勾选框，表示显示视觉映射，表示隐藏视觉映射。 映射类型：单击下拉选项设置视觉映射的映射类型，可以设置为连续型或分段型。 方向：单击下拉选项设置视觉映射的映射方向，可以设置为水平或垂直。 宽度：设置视觉映射的宽度。 高度：设置视觉映射的高度。 左侧：设置视觉映射时距离图层左侧的距离。 底部：设置视觉映射时距离图层底部的距离。 文字：设置视觉映射时文本的字体颜色和字号大小。 图5 视觉映射-世界地图 选中样式 颜色：单击颜色编辑器设置颜色。 标签颜色：单击颜色编辑器设置标签颜色。 数据值：单击“数据值”右侧的勾选框，表示显示数据值，表示隐藏数据值。 数据名：单击“数据名”右侧的勾选框，表示显示数据名，表示隐藏数据名。 文本样式：设置文本的颜色、字号和字体粗细样式。 图6 选中样式-世界地图

样式 尺寸位置 图表尺寸：设置图表的宽和高。单位为px。 图表位置：设置图表在画布中的位置。单位为px。 图1 尺寸位置-3D世界地图 添加子组件 地图的子组件包括地图飞线、地图散点、柱状层。 地图飞线 以动态飞线的形式连接地图中的两个地理位置，飞线的样式、位置的经纬值参考以下步骤进行配置。 单击“添加子组件”，添加地图飞线。 图2 添加地图飞线-3D世界地图 单击“地图飞线”，进入地图飞线的配置页面。 在“样式”页签，配置飞线的飞行速率、飞线粗细、飞线长度和颜色。 图3 配置地图飞线样式-3D世界地图 在“数据”页签，配置飞线的起点和终点的经纬度。 数据格式：from为飞线的起点，to为飞线的终点。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 地图散点 以散点的形式表现地图中的某些地理位置的数据信息，散点的样式、经纬度参考以下步骤进行配置。 单击“添加子组件”，添加地图散点。 图4 添加地图散点-3D世界地图 单击“地图散点”，进入地图散点的配置页面。 在“样式”页签，配置散点的散点大小、样式、颜色和透明度。 图5 配置地图散点样式-3D世界地图 在“数据”页签，配置散点的经纬度和大小。 数据格式：lon为散点的经度；lat为散点的纬度；value为散点的值，与样式中散点大小一起决定散点的大小，value值越大，散点越大。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 柱状层 以3D柱状的形式表现地图中的某些地理位置的数据信息，柱状层的样式、经纬度参考以下步骤进行配置。 单击“添加子组件”，添加柱状层。 图6 添加柱状层-3D世界地图 单击“柱状层”，进入柱状层的配置页面。 在“样式”页签，配置柱状层的柱子粗细、柱子的最小高度值、柱子的颜色和颜色透明度。 图7 配置柱状层样式-3D世界地图 在“数据”页签，配置柱子的经纬度和高度。 数据格式：lon为柱子的经度；lat为柱子的纬度；value为柱子的值，value值越大，柱子越高。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 全局样式 地图中心：设置地图中心在图层中的位置。 地球旋转：设置地图的缩放距离、水平旋转角度、垂直旋转角度。 地图颜色：设置地图中区域块的填充色。 边线选项：设置地图中区域边线的颜色和宽度。 图8 全局样式-3D世界地图

轮播视频 轮播视频是轮流播放各个地理位置的视频，视频格式支持*.mp4、*.flv。 图24 轮播视频 - 基础平面地图 样式 静音：开启或关闭静音模式。 控制条：显示或隐藏视频播放器中的进度控制条。 音量调节：视频的音量调节。 自定义播放时间：开启或关闭自定义播放时间。 播放时间：视频播放的时间。单位为ms。 宽度：视频播放器的宽度。单位为px。 背景色：视频播放器的背景色。 标点颜色：在地图中标示的地理位置的点的颜色。 边线选项：设置视频播放器窗口的边线的“样式”、“宽度”和“颜色”。 文本样式：设置在视频播放器上方显示的文本的“颜色”、“字体”、“字号”和“字体粗细”。显示的文本为“数据”中text字段的值。 数据 字段映射：悬浮文本的数据格式默认包含以下字段，请配置该字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 lat：地区的纬度。 lon：地区的经度。 video：视频地址。支持存储在OBS服务中的视频地址或公网视频地址。视频格式支持*.mp4、*.flv。 text：显示在视频窗口上方的标题。 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 预览结果：单击“预览结果”，显示选择的数据源的数据信息。单击“更新查询”可以在数据源变更时手动更新组件数据。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

悬浮文本 以悬浮文本的形式表现地图中的某些地理位置的数据信息。 图23 悬浮文本 - 基础平面地图 样式 边线选项 样式：悬浮文本框的边线样式。 宽度：悬浮文本框的边线宽度。 文本样式：悬浮文本的“字体”、“字号”、“字体粗细”。悬浮文本显示的文字为“数据”中text字段的值。 定速播放：开启后，悬浮文本将根据以下配置进行定速播放。默认为关闭。 悬浮数目：开启定速播放后，每次显示的悬浮文本数目。 浮现时间：悬浮文本的浮现时间。单位为ms。 停留时间：悬浮文本在地图上的停留时间。单位为ms。 消失时间：悬浮文本的消失时间。 数据 字段映射：悬浮文本的数据格式默认包含以下字段，请配置该字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 lat：地区的纬度。 lon：地区的经度。 text：在地区上方的悬浮文本。 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 预览结果：单击“预览结果”，显示选择的数据源的数据信息。单击“更新查询”可以在数据源变更时手动更新组件数据。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

地图热力层 地图热力层是以热力层的形式表现地图中的某些地理位置的数据信息。 图22 地图热力层 - 基础平面地图 样式 最小值透明度：热力点最小值的透明度。 最大值透明度：热力点最大值的透明度。 模糊半径：热力点的模糊半径。 半径：热力点的半径。 色带：热力点从外到内，支持设置“颜色1”~“颜色5”五个色带。 数据 字段映射：地图热力层的数据格式默认包含以下字段，请配置该字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 lat：地区的纬度。 lon：地区的经度。 value：该地区对应的热力点的值。 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 预览结果：单击“预览结果”，显示选择的数据源的数据信息。单击“更新查询”可以在数据源变更时手动更新组件数据。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

进阶版散点层 进阶版散点层是以散点的形式表现地图中的某些地理位置的数据信息，和地图散点相比，支持数据值映射散点的大小，支持自定义散点的图标。 图14 进阶版散点层 - 基础平面地图 样式 样式：散点的形状样式，有多种样式可供选择。 数据映射：勾选该选项时，散点颜色将根据数据大小显示不同的颜色，散点大小也将根据数据大小而显示不同的大小，数据大显示的散点大，数据小显示的散点小。“散点颜色”和“散点大小”的最小值、最大值以及无数据时的值支持自定义设置。散点大小的单位均为px。 图15 数据映射 动画效果：散点的动画效果样式。 呼吸范围：当“动画效果”不为“无”时，散点的呼吸范围，值越大呼吸范围越大。 动效速度：当“动画效果”不为“无”时，散点的动效速度，值越大动效速度越快。 标签：勾选该选项时，可在散点处显示标签。标签的设置如下： 映射字段：设置为“数据”页签中的某个字段名称，而非源数据的字段名称，当勾选“标签”时，将在散点处显示所选字段的值。 字体：标签的字体。 颜色：标签的颜色。 字号：标签的字号。 字体粗细：标签的字体粗细。 位置：标签相对于散点的位置。 水平偏移：距离所设置的“位置”的向右的水平偏移，单位为px。 垂直偏移：距离所设置的“位置”的向下的垂直偏移，单位为px。 图16 标签 选中样式：在预览大屏或查看大屏时，鼠标移至散点时显示的样式。设置“选中样式”后，可以单击页面右上角的预览按钮查看选中样式。展开“选中样式”设置如下参数： 颜色：鼠标移至散点时，显示的散点颜色。 数据值：显示或隐藏name字段的值，勾选时显示。 数据名：显示或隐藏value字段的值，勾选时显示。 文本样式：鼠标移至散点时，显示的提示信息的字体颜色、字号、字体粗细。 图17 选中样式 初始化值：在“交互”页签开启交互时，name字段的初始化值。 数据 图18 进阶版散点层-数据 字段映射：地图散点的数据格式包含以下字段，请配置各个字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 lon：散点的经度。 lat：散点的纬度。 name：散点所代表的地理位置的名称。 value：散点的值，与样式中的“散点大小”一起决定散点的大小，value值越大，散点越大。 type：单击按钮可以添加系列值，即可以选取type字段的某一个取值设置为一个系列，并设置该系列散点的显示样式。type字段为其他取值的散点则按照type字段的默认样式进行显示。 例如，某一个散点的type为"type":"snack"，则单击按钮设置系列值为“snack”。 图19 添加系列 img：散点的自定义图标的路径，可以设置为存储在OBS服务中的图片路径或公网图片路径。如果未设置该字段，则使用默认图标。 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 预览结果：单击“预览结果”，显示选择的数据源的数据信息。单击“更新查询”可以在数据源变更时手动更新组件数据。 交互 支持开启click事件和mouseover事件交互。关于组件交互的使用方法，请参考设置组件事件交互。

地图下钻 地图下钻是以下钻的形式表现地图中的某些地理位置的数据信息。 图20 添加地图下钻-基础平面地图 样式 颜色：访问区域的区块颜色。 透明度：访问区域的区块的透明度。 边线选项 颜色：访问区域的边线颜色。 宽度：访问区域的边线宽度。 线条样式：访问区域的边线线条样式。 阴影颜色：访问区域的边线阴影颜色。 标签：显示或隐藏标签。显示时，可设置标签文本的“字体”、“颜色”、“字号”、“字体粗细”。 缩放范围：访问区域的缩放比例。 数据 图21 地图下钻 - 数据 字段映射：地图下钻的数据格式默认包含1个字段，请配置该字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 name：访问的区域名称。 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 预览结果：单击“预览结果”，显示选择的数据源的数据信息。单击“更新查询”可以在数据源变更时手动更新组件数据。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

地图散点 地图散点是以散点的形式表现地图中的某些地理位置的数据信息。 图12 基础平面地图 - 地图散点 样式 样式：散点的形状样式，有多种样式可供选择。 动画效果：散点的动画效果样式。 散点大小：散点的大小。 呼吸范围：当“动画效果”不为“无”时，散点的呼吸范围，值越大呼吸范围越大。 动效速度：当“动画效果”不为“无”时，散点的动效速度，值越大动效速度越快。 内圈颜色：散点内圈的颜色。 外圈颜色：散点外圈的颜色。 选中样式：在预览大屏或查看大屏时，鼠标移至散点时显示的样式。设置“选中样式”后，可以单击页面右上角的预览按钮查看选中样式。展开“选中样式”设置如下参数： 颜色：鼠标移至散点时，显示的散点颜色。 数据值：显示或隐藏name字段的值，勾选时显示。 数据名：显示或隐藏value字段的值，勾选时显示。 文本样式：鼠标移至散点时，显示的提示信息文本的“颜色”、“字号”、“字体粗细”。 数据 图13 地图散点数据 字段映射：地图散点的数据格式包含以下4个字段，请配置各个字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 lon：散点的经度。 lat：散点的纬度。 name：散点所代表的地理位置的名称。 value：散点的值，与样式中的“散点大小”一起决定散点的大小，value值越大，散点越大。 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 预览结果：单击“预览结果”，显示选择的数据源的数据信息。单击“更新查询”可以在数据源变更时手动更新组件数据。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

地图飞线 地图飞线是以动态飞线的形式连接地图中的两个地理位置。 图8 基础平面地图 - 地图飞线 样式 飞线样式 耀斑大小：单位px。 飞行速率：耀斑飞行的速率。 飞线长度：飞线长度相对两个地理位置之间距离的占比。以起点到终点的距离为1个单位。 轨迹颜色：飞行轨迹的颜色。 轨迹宽度：单位px。 曲率：飞线的弯曲度。当曲率为0时，飞线显示为直线。 图9 飞线层 端点样式：显示或隐藏起点和终点，默认为隐藏。显示时，可以设置“起点样式”和“终点样式”。 起点样式 / 终点样式 样式：端点的形状样式，有多种样式可供选择。 内圈颜色：端点内圈的颜色。 外圈颜色：端点外圈的颜色。 动画效果：端点的动画效果。 呼吸范围：端点动态呼吸的范围。配置项“动画效果” 动效速度：端点动态呼吸的速度。 散点大小：端点的大小。 图10 端点样式 数据 图11 地图飞线数据 字段映射：地图飞线的数据格式包含以下2个字段，请配置以下2个字段映射到数据源中的字段名称，如果配置为空，则表示字段名称和所映射的数据源中的字段名称相同。 from：飞线起点位置的经度和纬度，经纬度之间以逗号分隔。 to：飞线终点位置的经度和纬度，经纬度之间以逗号分隔。 数据源的数据格式为JSON格式，示例如下： [ { "from": "116.85059,31.69078", "to": "118.69629,36.20882" }, { "from": "120.89355,37.09024", "to": "116.93848,31.61597" } ] 数据源类型：选择图表的数据源。系统提供了多种数据源供用户选择，您需要先添加数据源，具体操作请参见数据连接概述。 自动更新请求：勾选自动更新请求，并设置更新间隔后，数据将根据间隔时间自动轮询。 预览结果：单击“预览结果”，显示选择的数据源的数据信息。单击“更新查询”可以在数据源变更时手动更新组件数据。 交互 关于组件是否支持交互功能及交互的使用方法，请参考设置组件事件交互。

数据 上图中的示例数据如下： [ { "name": "北京", "value": 900 }, { "name": "上海", "value": 1200 }, { "name": "天津", "value": 1200 }, { "name": "重庆", "value": 1200 }, { "name": "山西", "value": 1400 }, { "name": "陕西", "value": 1800 }, { "name": "新疆", "value": 2400 }, { "name": "山东", "value": 5000 }, { "name": "浙江", "value": 2500 }, { "name": "福建", "value": 2600 }, { "name": "广东", "value": 2800 }, { "name": "广西", "value": 2900 }, { "name": "西藏", "value": 3300 }, { "name": "内蒙古", "value": 3300 }, { "name": "河南", "value": 3500 }, { "name": "江苏", "value": 3600 }, { "name": "海南", "value": 3700 }, { "name": "台湾", "value": 3800 }, { "name": "云南", "value": 3900 }, { "name": "贵州", "value": 3900 }, { "name": "四川", "value": 4100 }, { "name": "河北", "value": 4400 }, { "name": "吉林", "value": 4700 }, { "name": "安徽", "value": 5000 }, { "name": "香港", "value": 5000 }, { "name": "澳门", "value": 5100 }, { "name": "辽宁", "value": 5400 }, { "name": "甘肃", "value": 5800 }, { "name": "青海", "value": 5800 }, { "name": "江西", "value": 5800 }, { "name": "湖北", "value": 5300 }, { "name": "黑龙江", "value": 5300 }, { "name": "湖南", "value": 5300 }, { "name": "宁夏", "value": 5300 } ]

样式 尺寸位置 图表尺寸：设置图表的宽和高。单位为px。 图表位置：设置图表在画布中的位置。单位为px。 图1 尺寸位置-基础平面地图 添加子组件 在基础平面地图中可添加的子组件有：地图飞线、地图散点、进阶版散点层、地图下钻、地图热力层、悬浮文本、轮播视频。 地图子组件的相关操作如下： 添加子组件 在“样式”配置栏，单击“添加子组件”按钮，然后在弹出菜单中选择一个子组件，即可将该子组件添加到地图组件中。子组件添加完成后，在“添加子组件”按钮下方会显示所添加的子组件名称，例如“地图飞线”。 图2 添加子组件 编辑子组件 单击子组件名称就可以编辑子组件。 删除子组件 单击子组件名称后面的按钮，可以删除该子组件。 全局样式 地图：单击下拉列表选择选择访问的国家。 地图中心：设置地图中心在图层中的位置。 缩放范围：设置地图中心在图层中的缩放比例。 图3 全局样式-基础平面地图 填充设置 填充颜色：设置填充的颜色和透明度。 边线选择：设置边线的颜色和宽度。 图4 填充设置-基础平面地图 标签 显示/隐藏标签：单击“标签”右侧的勾选框，表示显示标签，表示隐藏标签。 字体：设置填充的颜色和透明度。 颜色：设置值标签的字体颜色。 字号：设置标签的字号大小。 字体粗细：设置标签的字体粗细样式。 图5 标签-基础平面地图 视觉映射 显示/隐藏视觉映射：单击“标签”右侧的勾选框，表示显示视觉映射，表示隐藏视觉映射。 映射类型：单击下拉选项设置视觉映射的映射类型，可以设置为连续型或分段型。 方向：单击下拉选项设置视觉映射的映射方向，可以设置为水平或垂直。 宽度：设置视觉映射的宽度。 高度：设置视觉映射的高度。 左侧：设置视觉映射时距离图层左侧的距离。 底部：设置视觉映射时距离图层底部的距离。 文字：设置视觉映射时文本的字体颜色和字号大小。 图6 视觉映射-基础平面地图 选中样式 颜色：单击颜色编辑器设置颜色。 数据值：单击“数据值”右侧的勾选框，表示显示数据值，表示隐藏数据值。 数据名：单击“数据名”右侧的勾选框，表示显示数据名，表示隐藏数据名。 提示文本： 文本样式：设置文本的颜色、字号和字体粗细样式。 提示框：设置提示框的内边距、背景色、自定义大小、边框颜色、边框宽度。 图7 选中样式-基础平面地图 开启缩放：开启后，在查看或预览大屏时可通过鼠标滚轮放大或缩小地图。 开启平移：开启后，在查看或预览大屏时可通过选中地图并拖动鼠标来平移地图。 初始化值：在“交互”页签开启交互时，name字段的初始化值。