XSQL 开源项目教程

1. 项目的目录结构及介绍

XSQL 项目的目录结构如下：

XSQL/
├── build-plugin.sh
├── conf
│   ├── xsql.properties
│   └── log4j.properties
├── docs
│   ├── FAQ.md
│   ├── README-CN.md
│   └── ...
├── src
│   ├── main
│   │   ├── java
│   │   │   └── ...
│   │   └── resources
│   │       └── ...
│   └── test
│       └── ...
├── README.md
└── ...

目录结构介绍

• build-plugin.sh: 用于编译 XSQL 插件的脚本。
• conf: 包含项目的配置文件，如 xsql.properties 和 log4j.properties。
• docs: 包含项目的文档，如常见问题解答 FAQ.md 和中文介绍 README-CN.md。
• src: 包含项目的源代码，分为 main 和 test 两个部分。
• README.md: 项目的主介绍文件。

2. 项目的启动文件介绍

XSQL 项目的启动文件主要是通过编译后的插件来启动。以下是启动步骤：

1. 编译插件:

   ./build-plugin.sh
   

   编译成功后，会在源码根目录生成 xsql-0.6.0-plugin-spark-2.4.3.tgz 文件。

2. 启动 XSQL: 解压生成的插件文件，并按照文档中的指引启动 XSQL。

3. 项目的配置文件介绍

XSQL 项目的配置文件主要位于 conf 目录下，包括 xsql.properties 和 log4j.properties。

xsql.properties

xsql.properties 文件包含 XSQL 的主要配置项，如数据源配置、执行引擎配置等。以下是一些关键配置项的示例：

# 数据源配置
xsql.datasources = hive,mysql,elasticsearch

# Hive 数据源配置
xsql.datasource.hive.type = hive
xsql.datasource.hive.url = jdbc:hive2://localhost:10000
xsql.datasource.hive.user = hive
xsql.datasource.hive.password = hive

# MySQL 数据源配置
xsql.datasource.mysql.type = mysql
xsql.datasource.mysql.url = jdbc:mysql://localhost:3306/dbname
xsql.datasource.mysql.user = root
xsql.datasource.mysql.password = root

# Elasticsearch 数据源配置
xsql.datasource.elasticsearch.type = elasticsearch
xsql.datasource.elasticsearch.url = http://localhost:9200

log4j.properties

log4j.properties 文件用于配置日志输出，包括日志级别、输出格式等。以下是一个简单的配置示例：

log4j.rootLogger=INFO, stdout

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

通过这些配置文件，可以灵活地调整 XSQL 的行为和日志输出，以满足不同的需求。