笔记本共享

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

现在是分享的季节，本着分享的精神，我们有一个新功能要与你分享——笔记本共享。现在你可以将你最喜欢的InfluxDB笔记本分享给任何你想分享的人。他们不需要有InfluxDB Cloud账户。他们只需点击你与他们分享的链接，就可以看到你分享的笔记本，以及你选择的日期范围。点击此链接查看我们的开发者Gene Hynson为了监测他家的Wyze摄像头检测到的声音和运动而构建的真正酷炫的IFTTT集成。

你可以在这里了解更多关于他是如何监测他家的信息。

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

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

那么，现在我已经构建了一个酷炫的笔记本，如何分享它呢？这非常简单。登录到你的InfluxDB Cloud账户，打开你想要分享的笔记本。如果你还没有保存，请点击“保存笔记本”。在右上角，有一个新的选项，如下面的截图所示（用红色圆圈圈出），用于分享笔记本。

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

选择令牌后，我们将生成一个您可以用来与您想分享的人分享笔记本的URL。

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

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

试一试吧，您还可以将分享链接发送给我（请通过以下邮箱发送：[email protected]），因为我很乐意查看您的笔记本。我们一直在寻找时间序列数据的有趣用途。

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

这需要多少钱？

这取决于您的账户。如果您有一个免费账户，只要总使用量保持在您的免费账户速率限制内，就没有费用。之后，查询将被速率限制，就像您自己查看笔记本一样。如果您是按需付费（PAYG）或年度账户，您将根据每次渲染共享笔记本时的查询付费，方式与您在笔记本中点击“运行”按钮一样。

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

如果您想限制对共享笔记本的访问（也许共享笔记本链接比您想象的要受欢迎得多），您只需从笔记本中删除分享链接或停用与分享链接关联的令牌，点击链接的人将收到错误页面。

有人可以使用我的令牌访问我账户中的其他数据吗？

不可以。当您生成共享笔记本URL时，您需要关联一个特定的令牌，然后该令牌将与分享URL关联。从理论上讲，您账户中任何具有适当桶访问权限的令牌都可以使用。然而，在实践中，我们建议为共享URL创建一个特定的令牌——这样，当您完成分享后，您就可以退役这个令牌。令牌不包括在URL中。相反，在幕后，我们创建一个访问密钥。当任何人点击链接时，我们将访问密钥与您的令牌匹配，如果它仍然有效，我们将运行查询并显示笔记本。

如果我分享后修改了我的笔记本怎么办？

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

我可以用同一个笔记本拥有多个分享URL吗？

目前不行。告诉我们您为什么需要这样，我们可以在将来考虑添加此功能。

我和我的同事能否为同一本笔记本生成不同的分享链接？

目前还不行。一旦某个用户生成了分享链接，该组织中的其他用户可以看到并分享该链接，但他们不能生成另一个链接，直到第一个链接被删除。如果您有不同用户在同一组织内需要不同分享链接的用例，请告诉我们。

拥有分享链接的人能否更改或删除我的笔记本？

不行，链接只赋予他们您选择的访问时间段内共享笔记本的读取权限。他们不能对笔记本进行任何更改或修改时间范围。他们只能看到您选择显示给他们数据。

我共享的笔记本总是显示最新数据吗？

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

如果我删除或停用生成分享链接时使用的令牌，分享链接仍然有效吗？

不，分享链接仅在令牌有效时才有效。如果您删除或停用令牌，您需要选择一个新的令牌并重新生成分享链接。

如果删除笔记本，链接仍然有效吗？

不，链接与笔记本相关联，如果笔记本不存在，就没有内容可以显示。

关于仪表板共享呢？

我们是从笔记本共享开始的，我们非常希望了解您对它的反馈。您可以在共享笔记本中使用演示模式来专注于您数据可视化。我们知道这并不完全等同于仪表板共享，但它是一个起点。