Merge pull request #28016 from taosdata/docs/ts-5424
docs: update docs to support ODBC x86 and views
This commit is contained in:
wade zhang
GitHub
commit
302d217697
|
|
@ -3,11 +3,11 @@ sidebar_label: ODBC
|
|||
title: TDengine ODBC
|
||||
---
|
||||
|
||||
TDengine ODBC 是为 TDengine 实现的 ODBC 驱动程序，支持 Windows 系统的应用（如 [PowerBI](https://powerbi.microsoft.com/zh-cn/) 等）通过 ODBC 标准接口访问本地、远程和云服务的 TDengine 数据库。
|
||||
TDengine ODBC 是为 TDengine 实现的 ODBC 驱动程序，支持 Windows 系统的应用（如 [PowerBI](https://powerbi.microsoft.com/zh-cn/) 等）通过 ODBC 标准接口访问本地、远程和云服务的 TDengine 数据库的数据表/视图。
|
||||
|
||||
TDengine ODBC 提供基于 WebSocket（推荐）和 原生连接两种方式连接 TDengine 数据库，使用时可以为 TDengine 数据源设置不同的连接方式。访问云服务时必须使用 WebSocket 连接方式。
|
||||
|
||||
注意：TDengine ODBC 只支持 64 位系统，调用 TDengine ODBC 必须通过 64 位的 ODBC 驱动管理器进行。因此调用 ODBC 的程序不能使用 32 位版本。
|
||||
注意：TDengine ODBC 支持 32/64 位 Windows 系统，调用 TDengine ODBC 需要通过相应位数的 ODBC 驱动管理器进行。在 32 位 Windows 系统或者 64 位 Windows 系统的 32 位应用程序中，仅支持使用 WebSocket 连接方式访问 TDengine 数据库。
|
||||
|
||||
想更多了解 TDengine 时序时序数据库的使用，可访问 [TDengine官方文档](https://docs.taosdata.com/intro/)。
|
||||
|
||||
|
|
@ -18,7 +18,7 @@ TDengine ODBC 提供基于 WebSocket（推荐）和 原生连接两种方式连
|
|||
|
||||
1. 仅支持 Windows 平台。Windows 上需要安装过 VC 运行时库，可在此下载安装 [VC运行时库](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) 如果已经安装VS开发工具可忽略。
|
||||
|
||||
2. 安装 TDengine Windows 客户端，版本在 3.2.1.0 或以上，都会包含 TDengine 的 ODBC 驱动。
|
||||
2. 安装 TDengine Windows 客户端。版本在 3.2.1.0 或以上，包含 TDengine 的 ODBC 64 位驱动；版本在 3.3.3.0 或以上，包含 TDengine 的 ODBC 32/64 位驱动。
|
||||
|
||||
## 配置数据源
|
||||
|
||||
|
|
@ -26,17 +26,19 @@ TDengine ODBC 提供基于 WebSocket（推荐）和 原生连接两种方式连
|
|||
|
||||
TDengine ODBC 支持两种连接 TDengine 数据库方式：Websocket 连接与 Native 连接，其区别如下：
|
||||
|
||||
1. 只有 Websocket 支持连接云服务
|
||||
1. 访问云服务仅支持使用 Websocket 连接方式。
|
||||
|
||||
2. Websocket 连接的兼容性更好，一般不需要随着 TDengine 数据库服务端升级而升级客户端的库。
|
||||
2. 32 位应用程序仅支持使用 WebSocket 连接方式。
|
||||
|
||||
3. Native 连接通常性能更好一点，但是必须与 TDengine 数据库服务端的版本保持一致。
|
||||
3. Websocket 连接的兼容性更好，一般不需要随着 TDengine 数据库服务端升级而升级客户端的库。
|
||||
|
||||
4. 对于一般用户，建议使用 **Websocket** 连接方式，性能与 Native 差别不大，兼容性更好。
|
||||
4. Native 连接通常性能更好一点，但是必须与 TDengine 数据库服务端的版本保持一致。
|
||||
|
||||
5. 对于一般用户，建议使用 **Websocket** 连接方式，性能与 Native 差别不大，兼容性更好。
|
||||
|
||||
### WebSocket 连接
|
||||
|
||||
1. 【开始】菜单搜索打开【ODBC 数据源(64 位)】管理工具（注意不要选择ODBC 数据源(32 位)）
|
||||
1. 【开始】菜单搜索打开【ODBC 数据源(32 位)】或者【ODBC 数据源(64 位)】管理工具
|
||||
|
||||
2. 选中【用户 DSN】标签页，通过【添加(D)】按钮进入"创建数据源"界面
|
||||
|
||||
|
|
@ -64,7 +66,7 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：Websocket 连接与
|
|||
|
||||
7. 也可以在第2步选择已经配置好的数据源名通过【配置】按钮进入配置页面，修改已有配置
|
||||
|
||||
### 原生连接（不支持云服务）
|
||||
### 原生连接（不支持云服务和 32 位应用程序）
|
||||
|
||||
1. 【开始】菜单搜索打开【ODBC 数据源(64 位)】管理工具（注意不要选择ODBC 数据源(32 位)）
|
||||
|
||||
|
|
|
|||
|
|
@ -8,35 +8,35 @@ Power BI是由Microsoft提供的一种商业分析工具。通过配置使用ODB
|
|||
|
||||
## 前置条件
|
||||
|
||||
安装完成Power BI Desktop软件并运行（如未安装，请从其官方地址下载最新的Windows操作系统X64版本）。
|
||||
安装完成Power BI Desktop软件并运行（如未安装，请从其官方地址下载最新的Windows操作系统 32/64 位版本）。
|
||||
|
||||
## 安装 ODBC 驱动
|
||||
|
||||
从TDengine官网下载最新的Windows操作系统X64客户端驱动程序，并安装在运行Power BI的机器上。安装成功后可在“ODBC数据源（64位）”管理工具中看到 TAOS_ODBC_DSN”驱动程序。
|
||||
从TDengine官网下载最新的Windows操作系统X64客户端驱动程序，并安装在运行Power BI的机器上。安装成功后可在“ODBC数据源（32位）”或者“ODBC数据源（64位）”管理工具中看到 TDengine 驱动程序。
|
||||
|
||||
## 配置ODBC数据源
|
||||
|
||||
配置ODBC数据源的操作步骤如下。
|
||||
|
||||
第1步，在Windows操作系统的开始菜单中搜索并打开“ODBC数据源（64位）”管理工具。
|
||||
第1步，在Windows操作系统的开始菜单中搜索并打开“ODBC数据源（32位）”或者“ODBC数据源（64位）”管理工具。
|
||||
第2步，点击“用户DSN”选项卡→“添加”按钮，进入“创建新数据源”对话框。
|
||||
第3步，选择想要添加的数据源后选择“TDengine”，点击“完成”按钮，进入TDengine ODBC数据源配置页面。填写如下必要信息。
|
||||
第3步，在“选择您想为其安装数据源的驱动程序”列表中选择“TDengine”，点击“完成”按钮，进入TDengine ODBC数据源配置页面。填写如下必要信息。
|
||||
- DSN：数据源名称，必填，比如“MyTDengine”。
|
||||
- 连接类型：勾选“WebSocket”复选框。
|
||||
- 服务地址：输入“taos://127.0.0.1:6041”。
|
||||
- URL：ODBC 数据源 URL，必填，比如“http://127.0.0.1:6041”。
|
||||
- 数据库：表示需要连接的数据库，可选，比如“test”。
|
||||
- 用户名：输入用户名，如果不填，默认为“root”。
|
||||
- 密码：输入用户密码，如果不填，默认为“taosdata”。
|
||||
第4步，点击“测试连接”按钮，测试连接情况，如果成功连接，则会提示“成功连接到taos://root:taosdata@127.0.0.1:6041”。
|
||||
|
||||
第4步，点击“测试连接”按钮，测试连接情况，如果成功连接，则会提示“成功连接到http://127.0.0.1:6041”。
|
||||
第5步，点击“确定”按钮，即可保存配置并退出。
|
||||
|
||||
## 导入TDengine数据到Power BI
|
||||
|
||||
将TDengine数据导入Power BI的操作步骤如下。
|
||||
|
||||
将TDengine数据导入Power BI的操作步骤如下:
|
||||
第1步，打开Power BI并登录后，点击“主页”→“获取数据”→“其他”→“ODBC”→“连接”，添加数据源。
|
||||
第2步，选择刚才创建的数据源名称，比如“MyTDengine”，点击“确定”按钮。在弹出的“ODBC驱动程序”对话框中，在左侧导航栏中点击“默认或自定义”→“连接”按钮，即可连接到配置好的数据源。进入“导航器”后，可以浏览对应数据库的数据表并加载。
|
||||
第3步，如果需要输入SQL，则可以点击“高级选项”选项卡，在展开的对话框中输入并加载数据。
|
||||
第2步，选择刚才创建的数据源名称，比如“MyTDengine”，如果需要输入SQL，则可以点击“高级选项”选项卡，在展开的对话框的编辑框中输入SQL语句。点击“确定”按钮，即可连接到配置好的数据源。
|
||||
第3步，进入“导航器”后，可以浏览对应数据库的数据表/视图并加载数据。
|
||||
|
||||
为了充分发挥Power BI在分析TDengine中数据方面的优势，用户需要先理解维度、度量、窗口切分查询、数据切分查询、时序和相关性等核心概念，之后通过自定义的SQL导入数据。
|
||||
- 维度：通常是分类（文本）数据，描述设备、测点、型号等类别信息。在TDengine的超级表中，使用标签列存储数据的维度信息，可以通过形如“select distinct tbname, tag1, tag2 from supertable”的SQL语法快速获得维度信息。
|
||||
|
|
@ -57,7 +57,7 @@ TDengine采用了一种独特的数据模型，以优化时序数据的存储和
|
|||
根据如下步骤，便可以体验通过Power BI生成时序数据报表的功能。
|
||||
第1步，使用TDengine的taosBenchMark快速生成1000块智能电表3天的数据，采集频率为1s。
|
||||
```shell
|
||||
taosBenchmark-t1000-n259200-S1000-H200-y
|
||||
taosBenchmark -t 1000 -n 259200 -S 1000 -y
|
||||
```
|
||||
第2步，导入维度数据。在Power BI中导入表的标签列，取名为tags，通过如下SQL获取超级表下所有智能电表的标签数据。
|
||||
```sql
|
||||
|
|
@ -65,7 +65,7 @@ TDengine采用了一种独特的数据模型，以优化时序数据的存储和
|
|||
```
|
||||
第3步，导入度量数据。在Power BI中，按照1小时的时间窗口，导入每块智能电表的电流均值、电压均值、相位均值，取名为data，SQL如下。
|
||||
```sql
|
||||
第3步，导入度量数据。在Power BI中，按照1小时的时间窗口，导入每块智能电表的电流均值、电压均值、相位均值，取名为data，SQL如下。
|
||||
select tbname, _wstart ws, avg(current), avg(voltage), avg(phase) from test.meters PARTITION by tbname interval(1h)
|
||||
```
|
||||
第4步，导入日期数据。按照1天的时间窗口，获得时序数据的时间范围及数据计数，SQL如下。需要在Power Query编辑器中将date列的格式从“文本”转化为“日期”。
|
||||
```sql
|
||||
|
|
|
|||
Loading…
Reference in New Issue