Hive 示例
准备安装文件
安装文件在inlong-sort-standalone/sort-standalone-dist/target/目录下,文件名是apache-inlong-sort-standalone-${project.version}-bin.tar.gz。
准备修改配置文件
首先,解压压缩包apache-inlong-sort-standalone-${project.version}-bin.tar.gz,然后从目录"conf/hive/"下拷贝3个文件到目录"conf/"。
- conf/common.properties,所有组件的基本配置参数
- conf/SortClusterConfig.conf,所有Sort任务的sink配置。, sink configuration of all sort tasks.
- conf/sid_hive_inlong6th_v3.conf,一个Sort任务的数据源配置,文件名和配置文件SortClusterConfig.conf中的Sort任务名一致,如果SortClusterConfig.conf中配置了多个Sort任务,那么会有多个Sort任务的数据源配置。
conf/common.properties配置样例
clusterId=hivev3-sz-sz1
nodeId=nodeId
metricDomains=Sort
metricDomains.Sort.domainListeners=org.apache.inlong.sort.standalone.metrics.prometheus.PrometheusMetricListener
metricDomains.Sort.snapshotInterval=60000
sortChannel.type=org.apache.inlong.sort.standalone.channel.BufferQueueChannel
sortSink.type=org.apache.inlong.sort.standalone.sink.hive.HiveSink
sortSource.type=org.apache.inlong.sort.standalone.source.sortsdk.SortSdkSource
sortClusterConfig.type=file
sortClusterConfig.file=SortClusterConfig.conf
sortSourceConfig.QueryConsumeConfigType=file
#sortTaskId.conf
#sortClusterConfig.type=manager
#sortSourceConfig.QueryConsumeConfigType=manager
#managerUrlLoaderType=org.apache.inlong.sort.standalone.config.loader.CommonPropertiesManagerUrlLoader
#sortClusterConfig.managerUrl=http://${manager_ip:port}/api/inlong/manager/openapi/sort/getClusterConfig
#sortSourceConfig.managerUrl=http://${manager_ip:port}/api/inlong/manager/openapi/sort/getSortSource
conf/SortClusterConfig.conf配置样例
{
"clusterName": "hivev3-sz-sz1",
"sortTasks": [{
"name": "sid_hive_inlong6th_v3",
"type": "HIVE",
"idParams": [{
"inlongGroupId": "atta",
"inlongStreamId": "0fc00000046",
"separator": "|",
"partitionIntervalMs": 3600000,
"idRootPath": "/user/hive/warehouse/t_inlong_v1_0fc00000046",
"partitionSubPath": "/{yyyyMMdd}/{yyyyMMddHH}",
"hiveTableName": "t_inlong_v1_0fc00000046",
"partitionFieldName": "dt",
"partitionFieldPattern": "yyyyMMddHH",
"msgTimeFieldPattern": "yyyy-MM-dd HH:mm:ss",
"maxPartitionOpenDelayHour": 8
}],
"sinkParams": {
"hdfsPath": "hdfs://10.160.139.123:9000",
"maxFileOpenDelayMinute": "5",
"tokenOvertimeMinute": "60",
"maxOutputFileSizeGb": "2",
"hiveJdbcUrl": "jdbc:hive2://10.160.142.179:10000",
"hiveDatabase": "default",
"hiveUsername": "hive",
"hivePassword": "hive"
}
}]
}
conf/sid_hive_inlong6th_v3.conf配置样例
{
"sortClusterName": "hivev3-sz-sz1",
"sortTaskId": "sid_hive_inlong6th_v3",
"cacheZones": {
"pc_atta6th_sz1": {
"zoneName": "pc_atta6th_sz1",
"serviceUrl": "http://9.139.53.86:8080",
"authentication": "eyJrZXlJZCI6InB1bHNhci04MnhhN24zZWs1ZHciLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJwdWxzYXItODJ4YTduM2VrNWR3X2FkbWluIn0.D5H_j8UQk8KYWHw_mzq2HmR393SnbL5Gz7JYCANBPnI",
"topics": [{
"topic": "pulsar-82xa7n3ek5dw/atta/atta_topic_1",
"partitionCnt": 10,
"topicProperties": {}
}],
"cacheZoneProperties": {},
"zoneType": "pulsar"
}
}
}
conf/common.properties配置参数
| 参数名 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|
| clusterId | Y | NA | 用来唯一标识一个inlong-sort-standalone集群 |
| nodeId | N | 本机IP | 当前节点ID |
| metricDomains | N | Sort | 指标汇总域名 |
| metricDomains.Sort.domainListeners | N | org.apache.inlong.sort.standalone.metrics.prometheus.PrometheusMetricListener | 指标汇总监听器类名列表,空格分隔 |
| metricDomains.Sort.snapshotInterval | N | 60000 | 订阅tube的重试超时时间,单位为ms |
| prometheusHttpPort | N | 8080 | org.apache.inlong.sort.standalone.metrics.prometheus.PrometheusMetricListener的参数,Prometheus的HttpServer端口 |
| sortChannel.type | N | org.apache.inlong.sort.standalone.channel.BufferQueueChannel | Channel类型 |
| sortSink.type | Y | NA | Sink类名,不同的分发类型使用不同的Sink类 |
| sortSource.type | N | org.apache.inlong.sort.standalone.source.sortsdk.SortSdkSource | Source类名 |
| sortClusterConfig.type | N | manager | 集群配置数据的加载来源,有三种方式:[文件,Manager,自定义类]。 |
| sortClusterConfig.file | N | SortClusterConfig.conf | 当集群配置数据加载来源是file时,在类路径下的配置文件名 |
| sortClusterConfig.managerUrl | N | NA | 集群配置数据加载来源是manager时,这里定义InlongManager的URL 比如:http://${manager ip:port}/api/inlong/manager/openapi/sort/standalone/getClusterConfig |
| sortSourceConfig.QueryConsumeConfigType | N | manager | Sort任务配置数据的加载来源,有三种方式:[文件,Manager,自定义类]。 如果加载路径是file的话,Sort任务配置文件是在类路径里,文件名的格式:${sortTaskId}.conf。 |
| sortSourceConfig.managerUrl | N | NA | Sort任务配置数据加载来源是manager时,这里定义InlongManager的URL 比如::http://${manager ip:port}/api/inlong/manager/openapi/sort/standalone/getSortSource |
SortClusterConfig.conf配置参数
- 可以从ClassPath的SortClusterConfig.conf源文件读取,但不支持实时更新
- 可以从Inlong Manager的HTTP接口获取配置,支持实时更新
| 参数名 | 是否必须 | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
| clusterName | Y | String | NA | 用来唯一标识一个inlong-sort-standalone集群 |
| sortTasks | Y | JsonArray<SortTaskConfig> | NA | Sort任务列表 |
SortTaskConfig配置参数
| 参数名 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|
| name | Y | NA | Sort任务名 |
| type | Y | NA | Sort任务类型,如:HIVE("hive"), TUBE("tube"), KAFKA("kafka"), PULSAR("pulsar"), ElasticSearch("ElasticSearch"), UNKNOWN("n") |
| idParams | Y | NA | Inlong数据流参数列表 |
| sinkParams | Y | NA | Sort任务参数 |
Sort-Hive任务的idParams配置参数
| 参数名 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|
| inlongGroupId | Y | NA | inlongGroupId |
| inlongStreamId | Y | NA | inlongStreamId |
| separator | Y | NA | 分隔符 |
| partitionIntervalMs | N | 3600000 | 分区间隔时间,单位毫秒 |
| idRootPath | Y | NA | Inlong数据流的Hdfs根目录 |
| partitionSubPath | Y | NA | Inlong数据流的分区子目录 |
| hiveTableName | Y | NA | Inlong数据流的Hive表名 |
| partitionFieldName | N | dt | Inlong数据流的分区字段名 |
| partitionFieldPattern | Y | NA | Inlong数据流的分区字段值格式,如{yyyyMMdd}、{yyyyMMddHH}、{yyyyMMddHHmm} |
| msgTimeFieldPattern | Y | NA | 消息生成时间的字段值格式,Java时间格式 |
| maxPartitionOpenDelayHour | N | 8 | 分区最大打开延迟时间,单位小时 |
Sort-Hive任务的sinkParams配置参数
| 参数名 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|
| hdfsPath | Y | NA | HDFS的NameNode |
| maxFileOpenDelayMinute | N | 5 | 单个HDFS文件最大写入时间,单位分钟 |
| tokenOvertimeMinute | N | 60 | 单个Inlong数据流的分区创建token最大占用时间,单位分钟 |
| maxOutputFileSizeGb | N | 2 | 单个HDFS文件最大大小,单位GB |
| hiveJdbcUrl | Y | NA | Hive的JDBC路径 |
| hiveDatabase | Y | NA | Hive的数据库 |
| hiveUsername | Y | NA | Hive的用户名 |
| hivePassword | Y | NA | Hive的密码 |
Sort-Hive任务的sid_hive_inlong6th_v3.conf配置
- 文件名格式:Sort任务名+".conf"。
- 可以从ClassPath的SortClusterConfig.conf源文件读取,但不支持实时更新。
- 可以从Inlong Manager的HTTP接口获取配置,支持实时更新。
sid_hive_inlong6th_v3.conf配置参数
| 参数名 | 是否必须 | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
| sortClusterName | Y | String | NA | 用来唯一标识一个inlong-sort-standalone集群 |
| sortTaskId | Y | String | NA | Sort任务名 |
| cacheZones | Y | JsonObject<String, JsonObject> | NA | 缓存层集群列表,格式:Map<cacheClusterName, CacheCluster> |
CacheCluster配置参数
| 参数名 | 是否必须 | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
| zoneName | Y | String | NA | 缓存层集群名 |
| zoneType | Y | String | NA | 缓存类型:[pulsar,tube,kafka] |
| serviceUrl | Y | String | NA | Pulsar的serviceUrl参数,或者Kafka的Broker列表 |
| authentication | Y | String | NA | Pulsar鉴权 |
| cacheZoneProperties | N | Map<String,String> | NA | 缓存层Consumer参数 |
| topics | N | List<Topic> | NA | 缓存层消费的Topic列表 |
Topic配置参数
| 参数名 | 是否必须 | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
| topic | Y | String | NA | Topic完整名,Pulsar:tenant/namespace/topic |
| partitionCnt | Y | Integer | NA | Topic分区数 |
| topicProperties | N | Map<String,String> | NA | 缓存层Topic的Consumer参数 |
启动inlong-sort-standalone应用
最后,执行脚本"./bin/sort-start.sh",启动sort-standalone应用,之后可以检查日志文件sort.log,确认启动情况。