笔记本共享

作者：Barbara Nelson / 用例, 产品, 开发者
2021 年 11 月 18 日

现在是分享的季节，本着分享的精神，我们有一个新功能与您分享 – 笔记本共享。现在您可以将您最喜欢的 InfluxDB 笔记本与您想分享的任何人分享。他们不需要拥有 InfluxDB Cloud 帐户。他们只需点击您与他们分享的链接，就可以看到您分享的笔记本，以及您选择的时间范围。点击此链接查看我们的一位开发者 Gene Hynson 构建的非常酷的 IFTTT 集成，用于监控来自他的 Wyze 摄像头的声音和运动检测。

您可以在此处了解更多关于他如何监控他的家。

如果您不熟悉笔记本，它们是 InfluxDB UI 中最近添加的功能，可以轻松构建 Flux 查询，验证查询结果，添加一些可视化，添加解释性注释，然后将您的查询合并到任务、客户端应用程序或您想使用的任何其他地方。要了解有关笔记本的更多信息，请查看文档。

笔记本的另一个很酷的功能是您可以在演示模式下显示它们。因此，您可以拥有一个包含各种查询面板、可视化和其他评论的笔记本，然后切换演示模式开关，我们就只显示可视化和评论，并隐藏笔记本的其余部分。看起来像一个仪表板，但内置于笔记本中。再次切换回演示模式开关，您就可以再次看到您的所有笔记本面板。

现在我已经构建了一个很酷的笔记本，我该如何分享它呢？非常简单。登录您的 InfluxDB Cloud 帐户，然后打开您想要分享的笔记本。如果您尚未保存它，请点击“保存笔记本”。在右上角，有一个新选项，在下面的屏幕截图中用红色圈出，用于分享笔记本。

当您点击分享选项时，您需要选择一个具有对笔记本中引用的资源具有读取权限的令牌。这将用于在显示共享笔记本时验证访问权限。

一旦您选择了令牌，我们将生成一个 URL，您可以使用该 URL 与您想分享的任何人分享笔记本。

只需复制 URL，将其粘贴到您的浏览器中，以便您可以查看最终结果，然后尽情分享。如果您想停止分享，只需选择 URL 旁边的“删除”选项，这将删除共享链接，或停用您用于生成 URL 的令牌。之后，任何尝试使用该链接的人都会收到错误消息。

如果您不想分享查询，而只想分享可视化，只需将笔记本切换到演示模式，然后生成共享链接。现在共享的笔记本看起来像这样 – 没有查询，只有一个漂亮的图表。

试一试，您也可以将共享链接发送给我（通过电子邮件发送至 [email protected]），因为我很乐意查看您的笔记本。我们一直在寻找时序数据的有趣用途。

以下是关于笔记本共享的一些常见问题。

费用是多少？

这取决于您的帐户。如果您拥有免费帐户，则不收取任何费用，只要总使用量保持在免费帐户的速率限制之内。之后，查询将受到速率限制，就像您自己查看笔记本一样。如果您使用的是按需付费 (PAYG) 或年度帐户，则每次呈现共享笔记本时，您都将为查询付费，方式与您在笔记本中点击“运行”完全相同。

如何停止为共享笔记本付费？

如果您想限制对共享笔记本的访问（也许该共享笔记本链接比您想象的更受欢迎），您可以从笔记本中删除共享链接，或停用与共享链接关联的令牌，任何点击它的人都会收到错误页面。

拥有共享链接的人可以使用我的令牌访问我帐户中的其他数据吗？

不会。当您生成共享笔记本 URL 时，系统会要求您关联一个特定的令牌，然后该令牌将与共享 URL 关联。理论上，您帐户中任何具有适当存储桶访问权限的令牌都可以使用。但是，在实践中，我们建议创建一个特定的令牌与共享 URL 一起使用 – 这样您可以在完成共享后停用此令牌。令牌不包含在 URL 中。相反，在幕后，我们创建了一个访问密钥。当任何人点击链接时，我们会将访问密钥与您的令牌进行匹配，如果仍然有效，我们将运行查询并显示笔记本。

如果我在共享笔记本后对其进行修改会怎么样？

对笔记本所做的任何更改都将立即通过您的共享链接提供。这使共享链接与您的笔记本完全保持同步，因此您无需担心人们查看过时的笔记本。需要注意的是，如果您将笔记本切换到演示模式，并生成共享链接，然后再切换回来，共享链接也会切换回来，并将以非演示模式显示。演示模式是笔记本的一部分，共享链接也与之保持同步。

同一个笔记本可以有多个共享 URL 吗？

目前还不行。请告诉我们您为什么可能需要这样做，我们可以考虑在未来添加它。

我和我的同事可以为同一个笔记本生成不同的共享 URL 吗？

目前还不行。一旦由一个用户生成共享 URL，该组织中的其他用户就可以查看和分享该 URL，但在第一个 URL 被删除之前，他们无法生成另一个 URL。如果您有在同一组织内的不同用户可能想要拥有不同共享 URL 的用例，请告诉我们。

拥有共享链接的人可以更改或删除我的笔记本吗？

不能，该链接仅让他们对共享笔记本具有读取访问权限，以及您选择的时间范围。他们无法对笔记本进行任何更改，也无法修改时间范围。他们只能看到您选择向他们显示的数据。

我的共享笔记本是否始终显示最新的数据？

这取决于您如何设置笔记本。如果笔记本中的时间范围是相对的（例如，过去 6 小时），那么每当他们点击共享笔记本 URL 时，他们都会看到过去 6 小时的数据。如果他们明天点击它，他们将看到明天的数据。如果时间范围是固定的（例如，2021 年 10 月 1 日至 2021 年 10 月 23 日），无论他们何时点击 URL，他们都将看到相同时间范围的相同数据。因此，您可以控制他们看到的数据 – 固定时间段或相对时间范围。

如果我删除或停用用于生成共享 URL 的令牌，共享 URL 还能用吗？

不能，共享 URL 仅在令牌有效时才有效。如果您删除或停用令牌，您将需要选择一个新令牌并重新生成共享 URL。

如果我删除笔记本，URL 还能用吗？

不能，URL 与笔记本关联，如果笔记本消失了，则没有任何内容可显示。

仪表板共享呢？

我们从笔记本共享开始，我们很乐意听取您关于其运行情况的反馈。您可以使用共享笔记本中的演示模式来专注于数据的可视化。我们知道它与仪表板共享并不完全相同，但这是一个起点。