Doris 可以创建外部表。创建完成后,可以通过 SELECT 语句直接查询外部表的数据,也可以通过 INSERT INTO SELECT 的方式导入外部表的数据。
Doris 外部表目前支持的数据源包括:
MySQL
Oracle
PostgreSQL
SQLServer
Hive
Iceberg
ElasticSearch
在 doris fe 和 be 目录下创建 jdbc_drivers 目录,将 doris 外部表支持的数据源 jar,放到此目录下;
RESOURCE 类型为 JDBC
官方支持的其它 type : https://doris.apache.org/zh-CN/docs/sql-manual/sql-reference/Data-Definition-Statements/Create/CREATE-RESOURCE?_highlight=resource
https://zhuanlan.zhihu.com/p/591172702
1. 创建 JDBC Resource
drop RESOURCE gp_resource;
CREATE RESOURCE gp_resource PROPERTIES (
"type"="jdbc",
"user"="root",
"password"="root",
"jdbc_url" = "jdbc:mysql://cdh003:3306/test?useSSL=false",
"driver_url" = "file:///opt/apache-doris-2.0.3-bin-x64/be/jdbc_drivers/mysql-connector-java-8.0.21.jar",
"driver_class" = "com.mysql.cj.jdbc.Driver"
);
2. 创建外部表
drop TABLE test.table_mysql;
CREATE TABLE test.table_mysql
(
`s_id` varchar(20) ,
`c_id` varchar(20) ,
`s_score` int(3)
)
ENGINE=JDBC
PROPERTIES
(
"resource" = "gp_resource",
"table" = "score",
"table_type"="mysql"
);
select * from table_mysql;
RESOURCE 类型为 odbc_catalog
参考 : https://blog.csdn.net/m0_52735414/article/details/128847022
官方支持的其它 ODBC : https://doris.apache.org/zh-CN/docs/advanced/resource?_highlight=odbc#odbc
1. linux 上提前安装好 ODBC,及相关数据库对应的 odbc 驱动;
所有的 BE 节点都安装上相同的Driver,并且安装路径相同,同时有相同的 ${DORIS_HOME}/be/conf/odbcinst.ini 的配置。
2. 在 BE 节点的 conf/odbcinst.ini,添加注册的的ODBC 驱动([MySQL ODBC 5.3.11]这部分)。
在文件 odbcinst.ini 末尾新增以下内容:
# Driver from the mysql-connector-odbc package
# Setup from the unixODBC package
[MySQL ODBC 5.3.11]
Description = ODBC for MySQL
Driver= /usr/lib64/libmyodbc5w.so.
FileUsage = 1
3. 在Doris中 建Resource
CREATE EXTERNAL RESOURCE `mysql_5_3_11` PROPERTIES (
"host" = "hadoop1",
"port" = "3306",
"user" = "root",
"password" = "000000",
"database" = "test",
"table" = "test_cdc",
"driver" = "MySQL ODBC 5.3.11", -- 名称要和上面[]里的名称一致
"odbc_type" = "mysql",
"type" = "odbc_catalog");
4. 基于 Resource 创建Doris 外表
CREATE EXTERNAL TABLE `test_odbc_5_3_11` (
`id` int NOT NULL ,
`name` varchar(255) null
) ENGINE=ODBC
COMMENT "ODBC"
PROPERTIES (
"odbc_catalog_resource" = "mysql_5_3_11", -- 名称就是 resource 的名称
"database" = "test_doris",
"table" = "test_cdc"
);
5. 插入数据
在 MySQL 端插入数据,在 ODBC 和 doris 都可以通过select 语句获取插入的数据;
在 doris 端插入数据,在 ODBC 和 MySQL 都可以通过select 语句获取插入的数据;
在 ODBC 端插入数据,在 doris 和 MySQL 都可以通过select 语句获取插入的数据;
不管在 ODBC,MySQL还是 doris 端,任何一端执行 insert 语句,在另外两个都可以通过 select 语句获取插入的数据;
直接创建 ENGINE=mysql
官方支持的其它 ENGINE : https://doris.apache.org/zh-CN/docs/sql-manual/sql-reference/Data-Definition-Statements/Create/CREATE-EXTERNAL-TABLE/
需要源码进行重新编译,否则建完表后执行查询语句报 [INTERNAL_ERROR]Don't support MySQL table, you should rebuild Doris with WITH_MYSQL option ON 错;
1. 找到 doris 源码家目录下 build.sh 文件;
2. 将 WITH_MYSQL='OFF' 改成 WITH_MYSQL='ON';
3. 重新编译;
CREATE EXTERNAL TABLE demo.student
(
`s_id` varchar(20) NOT NULL,
`s_name` varchar(20) NOT NULL DEFAULT '',
`s_birth` varchar(20) NOT NULL DEFAULT '',
`s_sex` varchar(10) NOT NULL DEFAULT ''
)
ENGINE=mysql
PROPERTIES
(
"host" = "cdh003",
"port" = "3306",
"user" = "root",
"password" = "root",
"database" = "test",
"table" = "student",
"charset" = "utf8mb4"
);
ENGINE=hive
将引擎改成 hive 时,在doris 2 的版本时执行查询语句会提示 : Unexpected exception: Hive external table is not supported, try to use hive catalog please;
解决方法 : doris 版本减低到 1 的版本,或者使用 hive catalog 来查询 hive 数据;
doris 1 版本 :
CREATE TABLE table_hive
(
id TINYINT,
name VARCHAR(50),
age INT
)
ENGINE=hive
PROPERTIES
(
"database" = "zz_test",
"table" = "a1",
"hive.metastore.uris" = "thrift://cdh005:9083"
);
select * from table_hive;
doris 2 版本 : 目前只支持 查询;
CREATE CATALOG hive PROPERTIES (
'type'='hms',
'hive.metastore.uris' = 'thrift://cdh005:9083'
);
SWITCH hive;
select * from table_hive;