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,确认启动情况。