ODBC 配置参考

你可以使用不同的配置选项控制 MapR Drill ODBC 驱动。你也可以使用这些选项在连接字符串或 odbc.ini 配置文件。

注意:如果你使用连接字符串去连接你的数据源,将配置属性配置在 odbc.ini 文件中。

配置选项

以下列表提供了配置选项和简要概述的清单。随后的章节中详细描述的更多选项:

属性 简述
Catalog DRILL 在该目录下,所有的 Schemas/Databases 都是有组织的。
ConnectionType 直接连接或者使用 Zookeeper 直接使用主机名和端口号连接到 Drill 服务。Zookeeper 连接到 Zookeeper 集群,使用 ZKQuorum 和 ZKClusterID 属性。
Driver MapR Drill ODBC 驱动 安装驱动的名称。
Host <主机名> 如果连接类型属性设置为直接连接,配置主机名去连接到 Drill 服务。
Port 31010 如果连接类型属性设置为直接连接,配置 TCP 端口为 Drill 服务监听的端口。
Schema < schema 名称 > 当查询没有显式指定该模式或存储插件时,默认使用数据库 Schema 或存储插件名称。
ZKClusterID drillbit1 如果连接类型属性设置为 Zookeeper,设置 ZKClusterID 的名称到 Drillbit 集群中。
ZKQuorum < IP 地址 >,< IP 地址 >... 如果连接类型属性设置为 Zookeeper,设置你的 Zookeeper 集群地址,以逗号分割。
AuthenticationType 不认证或基本认证 基本认证启用模拟
UID <用户名> 如果认证类型是基本认证,给 UID 设置一个用户名称。
PWD <密码> 如果认证类型是基本认证,给 PWD 设置一个密码。
AdvancedProperties {;; . . .} 使用分号分割属性,然后用{}连接所有的属性。
DisableAsync 0 或 1 禁用异步ODBC连接,使同步连接。状态的改变发生在驱动程序初始化和传播到所有驱动的 DSN 。

Catalog

该值默认是 DRILL 并且不能改变。该驱动程序添加了一个名为 DRILL 的合成目录,所有的 Schemas 和 Databases 都是有组织的。驱动映射到 ODBC schema 到 DRILL 目录。

Connection Type

ODBC 能够直接连接到 Drillbit 或者使用 Zookeeper Quorum。选择你连接的类型基于你的环境和 Drillbit 的配置,如下表所示:

环境 连接类型
Drillbit 运行在嵌入模式 直接连接 Drillbit
Drillbit 注册在 ZooKeeper 的测试环境 ZooKeeper Quorum 或直接连接 Drillbit
Drillbit 注册在 ZooKeeper 的生产环境 ZooKeeper Quorum

主机名和端口号

当使用 ZooKeeper 去连接 Drill,不要使用 IP 地址在连接字符串中。确保客户端系统能够 ping 通主机名。

ZKClusterID 和 ZKQuorum

默认的集群 ID 是 drillbits1。检查 drill-override.conf/conf 目录下。使用 cluster-id 和 zk.connect 的值作为 ZKClusterID 和 ZKQuorum。

连接到 ZooKeeper Quorum

当你选择去连接 ZooKeeper Quorum,ODBC 驱动连接到 ZooKeeper Quorum 要得到一系列可用的 Drillbits 在指定的集群中。然后,ODBC 驱动提交查询后会选择一个 Drillbit。所有的 Drillbits 在集群中查询,Drillbit 接受查询后的结果。 ODBC_to_Quorum.png

在生产环境中,你应该连接到 ZooKeeper Quorum 作为一个更加可靠的连接。如果一个 Drillbit 不可用了,其他在 ZooKeeper Quorum 中注册的 Drillbit 能够接受查询。

直接连接到 Drillbit

当你选择直接连接到 Drillbit,ODBC 驱动连接到 Drillbit 并提交查询。如果直接连接的 Drillbit 不是集群的一部分,Drillbit 会处理你连接的查询。如果你直接连接的 Drillbit 是集群的一部分,所有的 Drillbits 会处理查询。在任何情况下,Drillbit 的 ODBC 驱动连接会返回查询结果。 ODBC_to_Drillbit.png

Schema

一个 Schema 的名称或存储插件,来源于你配置使用的数据源的默认列表中。可以通过显示的指定查询中的模式来查询其他 Schema 的查询。

使用 Drill 资源管理器创建的视图不会出现在与数据源类型相关的模式下。相反,在保存视图时,可以从基于文件的 Schema 中访问视图。

驱动支持以下 Schema 类型:

  • HBase
  • 分布式文件系统(DFS),支持以下格式:
    • Parquet
    • JSON
    • CSV
    • TSV
  • Hive

高级属性

高级属性允许你自定义 DSN。 使用分号分割高级属性。

例如,以下高级属性字符串不包括名为 testabc 的 Schema;设置超时为 30 秒;并设置时间区域为 Coordinated Universal:

Time:HandshakeTimeout=30;QueryTimeout=30;
TimestampTZDisplayTimezone=utc;ExcludedSchemas=test,abc

下表列出和描述了高级属性,在使用 MapR Drill ODBC 驱动时,你可以对其进行配置。

属性名 默认值 描述
HandshakeTimeout 5 一个整数值表示,在放弃试图连接到数据源的驱动程序等待的秒数。当设置为0的值时,驱动程序不中止连接尝试。
QueryTimeout 180 一个整型值,该值表示在自动停止查询之前,该驱动程序的秒数。当设置为0的值时,驱动程序不会自动停止查询。
TimestampTZDisplayTimezone local 两种可能:本地时间戳是依赖于用户的时区。UTC 时间戳出现在 Coordinated Universal Time(UTC)。
ExcludedSchemas sys, INFORMATION_SCHEMA 罗列不出现在客户端应用程序中的 Schema,例如 Drill 资源管理器,Tableau 和Excel。使用逗号分割。
CastAnyToVarchar true 将 SQL 中列返回的任意数据类型,转化为 “VARCHAR”。
NumberOfPrefetchBuffers 5 在驱动程序中记录批处理队列的大小。当设置为值低于 1 时,默认值为 1。

连接字符串示例

如果你想连接到 Drill 数据源从应用程序中,而又不需要 DSN,你可以使用 ODBC 连接字符串。以下示例连接字符串是一个直接连接类型:

DRIVER=MapR Drill ODBC Driver;AdvancedProperties={HandshakeTimeout=0;QueryTimeout=0;TimestampTZDisplayTimezone=utc;ExcludedSchemas=sys,INFORMATION_SCHEMA;};Catalog=DRILL;Schema=hivestg;ConnectionType=Direct;Host=192.168.202.147;Port=31010

以下示例连接字符串属于一个 ZooKeeper 连接类型:

DRIVER=MapR Drill ODBC Driver;AdvancedProperties={HandshakeTimeout=0;QueryTimeout=0;TimestampTZDisplayTimezone=utc;ExcludedSchemas=sys, INFORMATION_SCHEMA;};Catalog=DRILL;Schema=;ConnectionType=ZooKeeper;ZKQuorum=192.168.39.43:5181;ZKClusterID=drillbits1

日志选项

配置日志记录以解决问题。为了配置日志,点击日志选项按钮在 ODBC DSN 设置对话框,然后设置一个日志等级和一个日志路径。

如果启用了日志记录,MapR Drill ODBC 驱动日志事件记录在以下日志文件路径,你可以配置以下属性:

  • driver.log:一个日志的驱动事件
  • drillclient.log:一个日志的 Drill 客户端事件。

日志等级

以下日志等级可用:

  • OFF:禁用日志。
  • FATAL:记录严重错误事件,可能导致驱动程序停止运行。
  • ERROR:记录错误事件,可以允许驱动程序继续运行。
  • WARNING:记录潜在有害情况的事件。
  • INFO:记录进程的高级事件。
  • DEBUG:记录可能有助于调试问题的详细事件。
  • TRACE:比调试级别更细粒度的事件。

启用日志

启用日志:

  1. 打开 mapr.drillodbc.ini 配置文件,进行文本编辑。
  2. 设置日志等级。例如:LogLevel=2
  3. 设置日志路径,例如:LogPath=/localhome/employee/Documents
  4. 保存 mapr.drillodbc.ini 配置文件。

禁用日志

禁用日志:

  1. 打开 mapr.drillodbc.ini 配置文件,进行文本编辑。
  2. 设置 LogLevel 键为 0
  3. 保存 mapr.drillodbc.ini 配置文件。
Copyright © smartloli 2016 all right reserved,powered by GitbookModify: 2016-08-26 06:59:28