137 lines
13 KiB
HTML
137 lines
13 KiB
HTML
<!DOCTYPE html><html lang='cn'><head><title>文档 | 涛思数据</title><meta name='description' content='TDengine是一个开源的专为物联网、车联网、工业互联网、IT运维等设计和优化的大数据平台。除核心的快10倍以上的时序数据库功能外，还提供缓存、数据订阅、流式计算等功能，最大程度减少研发和运维的工作量。'><meta name='keywords' content='大数据，Big Data，开源，物联网，车联网，工业互联网，IT运维, 时序数据库，缓存，数据订阅，消息队列，流式计算，开源，涛思数据，TAOS Data, TDengine'><meta name='title' content='文档 | 涛思数据'><meta property='og:site_name' content='涛思数据'/><meta property='og:title' content='文档 | 涛思数据'/><meta property='og:type' content='article'/><meta property='og:url' content='https://www.taosdata.com/cn/documentation/administrator-ch/index.php'/><meta property='og:description' content='TDengine是一个开源的专为物联网、车联网、工业互联网、IT运维等设计和优化的大数据平台。除核心的快10倍以上的时序数据库功能外，还提供缓存、数据订阅、流式计算等功能，最大程度减少研发和运维的工作量。' /><link rel='canonical' href='https://www.taosdata.com/cn/documentation/administrator-ch/index.php'/><script src='../lib/jquery-3.4.1.min.js' type='application/javascript'></script><link href='../lib/bootstrap.min.css' rel='stylesheet'><link href='../styles/base.min.css' rel='stylesheet'><link rel='stylesheet' href='../lib/docs/taosdataprettify.css'><link rel='stylesheet' href='../lib/docs/docs.css'><script src='../lib/docs/prettify.js'></script><script src='../lib/docs/prettyprint-sql.js'></script></head><body><script>$('#documentation-href').addClass('active')</script><div class='container-fluid'><main class='content-wrapper'><section class='documentation'><a href='../index.html'>回去</a><h1>系统管理</h1>
|
||
<a class='anchor' id='文件目录结构'></a><h2>文件目录结构</h2>
|
||
<p>安装TDengine后，默认会在操作系统中生成下列目录或文件：</p>
|
||
<figure><table>
|
||
<thead>
|
||
<tr>
|
||
<th>目录/文件</th>
|
||
<th style="text-align:left;">说明</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>/etc/taos/taos.cfg</td>
|
||
<td style="text-align:left;">TDengine默认[配置文件]</td>
|
||
</tr>
|
||
<tr>
|
||
<td>/usr/local/taos/driver</td>
|
||
<td style="text-align:left;">TDengine动态链接库目录</td>
|
||
</tr>
|
||
<tr>
|
||
<td>/var/lib/taos</td>
|
||
<td style="text-align:left;">TDengine默认数据文件目录,可通过[配置文件]修改位置.</td>
|
||
</tr>
|
||
<tr>
|
||
<td>/var/log/taos</td>
|
||
<td style="text-align:left;">TDengine默认日志文件目录,可通过[配置文件]修改位置</td>
|
||
</tr>
|
||
<tr>
|
||
<td>/usr/local/taos/bin</td>
|
||
<td style="text-align:left;">TDengine可执行文件目录</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></figure>
|
||
<a class='anchor' id='可执行文件'></a><h3>可执行文件</h3>
|
||
<p>TDengine的所有可执行文件默认存放在 <em>/usr/local/taos/bin</em> 目录下。其中包括：</p>
|
||
<ul>
|
||
<li><em>taosd</em>：TDengine服务端可执行文件</li>
|
||
<li><em>taos</em>： TDengine Shell可执行文件</li>
|
||
<li><em>taosdump</em>：数据导出工具</li>
|
||
<li><em>rmtaos</em>： 一个卸载TDengine的脚本, 请谨慎执行</li>
|
||
</ul>
|
||
<p>您可以通过修改系统配置文件taos.cfg来配置不同的数据目录和日志目录</p>
|
||
<a class='anchor' id='服务端配置'></a><h2>服务端配置</h2>
|
||
<p>TDengine系统后台服务由taosd提供，可以在配置文件taos.cfg里修改配置参数，以满足不同场景的需求。配置文件的缺省位置在/etc/taos目录，可以通过taosd命令行执行参数-c指定配置文件目录。比如taosd -c /home/user来指定配置文件位于/home/user这个目录。</p>
|
||
<p>下面仅仅列出一些重要的配置参数，更多的参数请看配置文件里的说明。各个参数的详细介绍及作用请看前述章节。<strong>注意：配置修改后，需要重启<em>taosd</em>服务才能生效。</strong></p>
|
||
<ul>
|
||
<li>internalIp: 对外提供服务的IP地址，默认取第一个IP地址</li>
|
||
<li>mgmtShellPort：管理节点与客户端通信使用的TCP/UDP端口号（默认值是6030）。此端口号在内向后连续的5个端口都会被UDP通信占用，即UDP占用[6030-6034]，同时TCP通信也会使用端口[6030]。</li>
|
||
<li>vnodeShellPort：数据节点与客户端通信使用的TCP/UDP端口号（默认值是6035）。此端口号在内向后连续的5个端口都会被UDP通信占用，即UDP占用[6035-6039]，同时TCP通信也会使用端口[6035]</li>
|
||
<li>httpPort：数据节点对外提供RESTful服务使用TCP，端口号[6020]</li>
|
||
<li>dataDir: 数据文件目录，缺省是/var/lib/taos</li>
|
||
<li>maxUsers：用户的最大数量</li>
|
||
<li>maxDbs：数据库的最大数量</li>
|
||
<li>maxTables：数据表的最大数量</li>
|
||
<li>enableMonitor: 系统监测标志位，0：关闭，1：打开</li>
|
||
<li>logDir: 日志文件目录，缺省是/var/log/taos</li>
|
||
<li>numOfLogLines：日志文件的最大行数</li>
|
||
<li>debugFlag: 系统debug日志开关，131：仅错误和报警信息，135：调试信息，143：非常详细的调试信息</li>
|
||
</ul>
|
||
<p>不同应用场景的数据往往具有不同的数据特征，比如保留天数、副本数、采集频次、记录大小、采集点的数量、压缩等都可完全不同。为获得在存储上的最高效率，TDengine提供如下存储相关的系统配置参数：</p>
|
||
<ul>
|
||
<li>days：一个数据文件覆盖的时间长度，单位为天</li>
|
||
<li>keep：数据库中数据保留的天数</li>
|
||
<li>rows: 文件块中记录条数</li>
|
||
<li>comp: 文件压缩标志位，0：关闭，1:一阶段压缩，2:两阶段压缩</li>
|
||
<li>ctime：数据从写入内存到写入硬盘的最长时间间隔，单位为秒</li>
|
||
<li>clog：数据提交日志(WAL)的标志位，0为关闭，1为打开</li>
|
||
<li>tables：每个vnode允许创建表的最大数目</li>
|
||
<li>cache: 内存块的大小（字节数）</li>
|
||
<li>tblocks: 每张表最大的内存块数</li>
|
||
<li>ablocks: 每张表平均的内存块数</li>
|
||
<li>precision：时间戳为微秒的标志位，ms表示毫秒，us表示微秒</li>
|
||
</ul>
|
||
<p>对于一个应用场景，可能有多种数据特征的数据并存，最佳的设计是将具有相同数据特征的表放在一个库里，这样一个应用有多个库，而每个库可以配置不同的存储参数，从而保证系统有最优的性能。TDengine容许应用在创建库时指定上述存储参数，如果指定，该参数就将覆盖对应的系统配置参数。举例，有下述SQL： </p>
|
||
<pre><code> create database demo days 10 cache 16000 ablocks 4</code></pre>
|
||
<p>该SQL创建了一个库demo, 每个数据文件保留10天数据，内存块为16000字节，每个表平均占用4个内存块，而其他参数与系统配置完全一致。</p>
|
||
<a class='anchor' id='客户端配置'></a><h2>客户端配置</h2>
|
||
<p>TDengine系统的前台交互客户端应用程序为taos，它与taosd共享同一个配置文件taos.cfg。运行taos时，使用参数-c指定配置文件目录，如taos -c /home/cfg，表示使用/home/cfg/目录下的taos.cfg配置文件中的参数，缺省目录是/etc/taos。更多taos的使用方法请见<a href="#_TDengine_Shell命令行程序">Shell命令行程序</a>。本节主要讲解taos客户端应用在配置文件taos.cfg文件中使用到的参数。</p>
|
||
<p>客户端配置参数列表及解释</p>
|
||
<ul>
|
||
<li>masterIP：客户端默认发起请求的服务器的IP地址</li>
|
||
<li>charset：指明客户端所使用的字符集，默认值为UTF-8。TDengine存储nchar类型数据时使用的是unicode存储，因此客户端需要告知服务自己所使用的字符集，也即客户端所在系统的字符集。</li>
|
||
<li>locale：设置系统语言环境。Linux上客户端与服务端共享</li>
|
||
<li>defaultUser：默认登录用户，默认值root</li>
|
||
<li>defaultPass：默认登录密码，默认值taosdata</li>
|
||
</ul>
|
||
<p>TCP/UDP端口，以及日志的配置参数，与server的配置参数完全一样。</p>
|
||
<p>启动taos时，你也可以从命令行指定IP地址、端口号，用户名和密码，否则就从taos.cfg读取。</p>
|
||
<a class='anchor' id='用户管理'></a><h2>用户管理</h2>
|
||
<p>系统管理员可以在CLI界面里添加、删除用户，也可以修改密码。CLI里SQL语法如下：</p>
|
||
<pre><code>CREATE USER user_name PASS ‘password’</code></pre>
|
||
<p>创建用户，并制定用户名和密码，密码需要用单引号引起来</p>
|
||
<pre><code>DROP USER user_name</code></pre>
|
||
<p>删除用户，限root用户使用</p>
|
||
<pre><code>ALTER USER user_name PASS ‘password’ </code></pre>
|
||
<p>修改用户密码, 为避免被转换为小写，密码需要用单引号引用</p>
|
||
<pre><code>SHOW USERS</code></pre>
|
||
<p>显示所有用户</p>
|
||
<a class='anchor' id='数据导入'></a><h2>数据导入</h2>
|
||
<p>TDengine提供两种方便的数据导入功能，一种按脚本文件导入，一种按数据文件导入。</p>
|
||
<p><strong>按脚本文件导入</strong></p>
|
||
<p>TDengine的shell支持source filename命令，用于批量运行文件中的SQL语句。用户可将建库、建表、写数据等SQL命令写在同一个文件中，每条命令单独一行，在shell中运行source命令，即可按顺序批量运行文件中的SQL语句。以‘#’开头的SQL语句被认为是注释，shell将自动忽略。</p>
|
||
<p><strong>按数据文件导入</strong></p>
|
||
<p>TDengine也支持在shell对已存在的表从CSV文件中进行数据导入。每个CSV文件只属于一张表且CSV文件中的数据格式需与要导入表的结构相同。其语法如下</p>
|
||
<pre><code class="mysql language-mysql">insert into tb1 file a.csv b.csv tb2 c.csv …
|
||
import into tb1 file a.csv b.csv tb2 c.csv …</code></pre>
|
||
<a class='anchor' id='数据导出'></a><h2>数据导出</h2>
|
||
<p>为方便数据导出，TDengine提供了两种导出方式，分别是按表导出和用taosdump导出。</p>
|
||
<p><strong>按表导出CSV文件</strong></p>
|
||
<p>如果用户需要导出一个表或一个STable中的数据，可在shell中运行</p>
|
||
<pre><code>select * from <tb_name> >> a.csv</code></pre>
|
||
<p>这样，表tb中的数据就会按照CSV格式导出到文件a.csv中。</p>
|
||
<p><strong>用taosdump导出数据</strong></p>
|
||
<p>TDengine提供了方便的数据库导出工具taosdump。用户可以根据需要选择导出所有数据库、一个数据库或者数据库中的一张表,所有数据或一时间段的数据，甚至仅仅表的定义。其用法如下：</p>
|
||
<ul>
|
||
<li>导出数据库中的一张或多张表：taosdump [OPTION…] dbname tbname …</li>
|
||
<li>导出一个或多个数据库： taosdump [OPTION…] --databases dbname…</li>
|
||
<li>导出所有数据库（不含监控数据库）：taosdump [OPTION…] --all-databases</li>
|
||
</ul>
|
||
<p>用户可通过运行taosdump --help获得更详细的用法说明</p>
|
||
<a class='anchor' id='系统连接、任务查询管理'></a><h2>系统连接、任务查询管理</h2>
|
||
<p>系统管理员可以从CLI查询系统的连接、正在进行的查询、流式计算，并且可以关闭连接、停止正在进行的查询和流式计算。CLI里SQL语法如下：</p>
|
||
<pre><code>SHOW CONNECTIONS</code></pre>
|
||
<p>显示数据库的连接，其中一列显示ip:port, 为连接的IP地址和端口号。</p>
|
||
<pre><code>KILL CONNECTION <connection-id></code></pre>
|
||
<p>强制关闭数据库连接，其中的connection-id是SHOW CONNECTIONS中显示的 ip:port字串，如“192.168.0.1:42198”，拷贝粘贴即可。</p>
|
||
<pre><code>SHOW QUERIES</code></pre>
|
||
<p>显示数据查询，其中一列显示ip:port:id, 为发起该query应用的IP地址，端口号，以及系统分配的ID。</p>
|
||
<pre><code>KILL QUERY <query-id></code></pre>
|
||
<p>强制关闭数据查询，其中query-id是SHOW QUERIES中显示的ip:port:id字串，如“192.168.0.1:42198:11”，拷贝粘贴即可。</p>
|
||
<pre><code>SHOW STREAMS</code></pre>
|
||
<p>显示流式计算，其中一列显示ip:port:id, 为启动该stream的IP地址、端口和系统分配的ID。</p>
|
||
<pre><code>KILL STREAM <stream-id></code></pre>
|
||
<p>强制关闭流式计算，其中的中stream-id是SHOW STREAMS中显示的ip:port:id字串，如“192.168.0.1:42198:18”，拷贝粘贴即可。</p>
|
||
<a class='anchor' id='系统监控'></a><h2>系统监控</h2>
|
||
<p>TDengine启动后，会自动创建一个监测数据库SYS，并自动将服务器的CPU、内存、硬盘空间、带宽、请求数、磁盘读写速度、慢查询等信息定时写入该数据库。TDengine还将重要的系统操作（比如登录、创建、删除数据库等）日志以及各种错误报警信息记录下来存放在SYS库里。系统管理员可以从CLI直接查看这个数据库，也可以在WEB通过图形化界面查看这些监测信息。</p>
|
||
<p>这些监测信息的采集缺省是打开的，但可以修改配置文件里的选项enableMonitor将其关闭或打开。</p><a href='../index.html'>回去</a></section></main></div><?php include($s.'/footer.php'); ?><script>$('pre').addClass('prettyprint linenums');PR.prettyPrint()</script><script src='lib/docs/liner.js'></script></body></html> |