TDengine Cloud是一个全托管的时序数据处理云服务平台，它是基于开源时序数据库（Time Series Database,TSDB）TDengine开发的。TDengine Cloud可以帮助您简化时序数据管理，提供简单快速的数据插入和分析，实现简单安全的数据共享，提供企业级时序数据库云解决方案。
在本文中，我们将重点介绍TDengine Cloud的数据分享功能，它可以让您轻松地与内部和外部的合作伙伴、客户和利益相关者共享您的时序数据，无论是整个实例、实时数据库还是单个连续SQL查询，只需一个邮箱地址即可。
数据分享的场景
使用TDengine Cloud的数据分享功能，您可以应对多种数据分享的场景，例如：
- 与内部团队共享整个实例或数据库：如果您想让您的内部团队成员拥有完整的开发权限，可以快速地为他们分配整个实例或数据库的访问权限，让他们可以插入、查询、修改和删除数据。
- 与外部客户共享特定数据库资源：如果您想让您的外部客户只能查看特定的数据库资源，例如某个表、超级表或视图，可以为他们创建一个只读角色，并限制他们只能访问这些资源。
- 与利益相关者共享单个连续SQL查询：如果您想让您的利益相关者只看到部分甚至加工后的数据，那么你可以用 SQL 定义一个主题，在 SQL 里可以指定各种过滤条件，将这个主题分享给对方即可。例如某个指标、统计量或报表，可以为他们创建一个主题，对方可以通过订阅这个主题实时获取数据。
数据分享的步骤
使用TDengine Cloud的数据分享功能，您只需简单地完成以下几个步骤：
- 登录TDengine Cloud控制台，并选择要共享数据的实例和数据库。
- 在左侧菜单栏中选择“用户”或“数据订阅-主题”，根据您要共享的数据层级和粒度，选择相应的功能模块。
- 点击“添加新用户”或“添加新主题”，输入对方的邮箱地址，并设置相应的角色、用户组、权限模板、过期时间等参数。
- 点击“新增”，完成数据分享。对方将收到一份包含安全访问令牌的邮件，可以通过该令牌访问您共享的数据。
数据分享的示例
为了让您更直观地了解TDengine Cloud的数据分享功能，我们将以一个简单的示例来演示。
假设您是一个智能家居公司的数据分析师，您使用TDengine Cloud来存储和分析您的设备数据。您想与您的合作伙伴共享一些数据，让他们可以查看您的设备状态、性能和用户行为等信息。
首先，您需要登录TDengine Cloud控制台，并选择您的实例和数据库。假设您的实例名为smart_home，您的数据库名为device_data。
然后，您需要在左侧菜单栏中选择“用户”，并点击“添加新用户”。在弹出的对话框中，输入您合作伙伴的邮箱地址，例如partner@example.com，并选择一个角色。假设您想让他们只能查看数据库中的某些表，例如device_status和device_performance，那么您可以选择“只读”角色，并在“资源权限”中勾选这两个表。最后，点击“新增”，完成用户添加。
此时，您的合作伙伴将收到一封包含安全访问令牌的邮件，他们可以通过该令牌登录TDengine Cloud控制台，并查看您共享的数据。他们只能看到device_status和device_performance两个表，并且只能执行查询操作，不能执行插入、修改或删除操作。如果他们尝试访问其他表或执行其他操作，将会收到权限不足的提示。
另外，如果您想与您的利益相关者共享一个连续SQL查询的结果，例如每小时统计一次设备在线率和故障率，并生成一个报表，那么您可以使用“数据订阅”功能来实现。具体步骤如下：
在左侧菜单栏中选择“数据订阅”➡️“主题”，并点击“添加新主题”。
在弹出的对话框中，输入一个主题名称，例如device_report，并输入一个SQL语句，例如：
select count(*) as total_devices, count(case when status = 'online' then 1 end) as online_devices, count(case when status = 'offline' then 1 end) as offline_devices, count(case when performance < 80 then 1 end) as faulty_devices from device_status interval(1h) sliding(1h);然后，在“数据订阅-共享主题”中选择要共享该主题的用户或用户组，并勾选该主题。
最后，点击“新增”，完成主题添加。
此时，您的利益相关者将收到一封包含安全访问令牌和主题ID的邮件，他们可以通过该令牌和主题ID订阅该主题，并接收实时推送的数据。他们只能看到该主题的数据，并且不能执行任何操作。如果他们尝试订阅其他主题或执行其他操作，将会收到权限不足的提示。如果他们在过期时间之后尝试订阅数据，将会收到令牌失效的提示。
数据分享的总结
通过以上的介绍和示例，您应该对TDengine Cloud的数据分享功能有了一个初步的了解。TDengine Cloud的数据分享功能可以让您轻松地与内部和外部的合作伙伴、客户和利益相关者共享您的时序数据，无论是整个实例、数据库还是单个连续SQL查询，只需一个邮箱地址即可。您还可以通过设置访问过期时间、数据加密和安全访问令牌等方式，对用户或用户组的访问权限进行精细控制，保证您的数据不被泄露或滥用。
如果您想了解更多关于TDengine Cloud的更多，请查看文档。
