公共分享
只有管理员可以创建公共链接和iframe。
管理员可以创建和共享公共链接(URL)来分享问题和仪表板。人们可以将其视为独立的目的地(URL)或嵌入在其他页面或应用程序中的iframe。在两种情况下,公共项目将显示你的问题或仪表板的静态(只读)结果,因此访客无法自行深入查看底层数据。
为问题创建公共链接
管理员可以在问题的右下角找到“分享”图标。您可以为查看问题创建链接,或导出问题的结果。
为仪表板创建公共链接
要通过公共链接共享仪表板,管理员可以在右上角菜单中点击“分享”按钮。
要嵌入仪表板,请参阅静态嵌入。
公共链接导出CSV、XLSX、JSON格式的查询结果
导出选项仅适用于问题,不适用于仪表板。
要创建人们可以使用的公共链接以下载问题的结果
- 单击问题的“分享”图标。
- 选择“公共链接”。
- 单击您想要的文件格式(在“公共链接”URL下方):CSV、XLSX或JSON。
在新标签页中打开公共链接以测试下载。
导出原始、未格式化的查询结果
要导出原始、未格式化的行,您需要将?format_rows=false
附加到Metabase生成的URL。例如,如果您创建一个用于CSV下载的公共链接,则URL看起来如下
https://www.example.com/public/question/cf347ce0-90bb-4669-b73b-56c73edd10cb.csv?format_rows=false
默认情况下,Metabase将导出包含您添加的任何格式化的查询结果(例如,如果您将带有浮点的列格式化为以百分比显示(0.42 -> 42%))。
有关导出格式端点的说明,请参阅文档。
使用公共链接模拟钻取
由于公共链接不提供人们访问您的原始数据,因此Metabase的自动钻取在公共仪表板上无法工作。
您可以通过设置一个自定义点击行为来在公共仪表板上模拟钻取,该行为可以将人们从一个公共链接发送到另一个公共链接。
- 创建第二个仪表板作为目标仪表板。
- 创建目标仪表板的公共链接。
- 复制目标仪表板的公共链接。
- 在您的主仪表板上,创建一个类型为“URL”的自定义目标。
- 将自定义目标设置为目标仪表板的公共链接。
- 可选:通过在目标URL末尾添加查询参数,从主仪表板传递一个过滤器值到目标仪表板
/public/dashboard/?child_filter_name={{parent_column_name}}
例如,如果您有一个显示发票数据的公共仪表板,您可以将点击时的计划名称传递给一个显示账户数据的公共仪表板。
公共嵌入
如果您想将问题或仪表板嵌入到简单的网页或应用中的iframe中
- 点击您的问题或仪表板的共享图标。
- 点击嵌入。
- 点击公共嵌入。
- 复制Metabase为您生成的iframe片段。
- 将iframe片段粘贴到您选择的目的地。
要自定义问题或仪表板的外观,您可以通过公共嵌入参数更新iframe的src
属性。
公共嵌入参数
要将外观或过滤器设置应用到公共嵌入,您可以在iframe的src
属性末尾添加参数。
注意,您可能找到公共嵌入背后的公共链接URL。如果有人获得访问公共链接URL的权限,他们可以从URL中删除参数以查看原始问题或仪表板(即,没有任何外观或过滤器设置)。
如果您想创建一个防止人们更改过滤器名称或值的受保护嵌入,请查看静态嵌入。
外观参数
要切换外观设置,请向iframe中公共链接的末尾添加hash参数。
参数名称 | 可能的值 |
---|---|
bordered | true, false |
titled | true, false |
theme | null, transparent, night |
hide_parameters | filter name |
font¹ | font name |
hide_download_button² | true, false |
¹ 仅在专业和企业计划中可用。
² 仅在专业和企业计划中可用,且仅隐藏问题上的下载按钮(不适用于仪表板)。
例如,要嵌入具有多个外观参数的仪表板
/dashboard/42#theme=night&titled=true&bordered=false
要嵌入没有过滤器小部件且没有下载按钮的问题
/question/42#hide_parameters=filter_name&hide_download_button=true
有关使用hide_parameters
隐藏过滤器小部件的更多信息,请参阅下一节关于过滤器参数。
过滤器参数
您可以在公共嵌入中显示您的问题或仪表板的过滤视图。请确保您已经设置了一个问题过滤器或仪表板过滤器。
要将过滤器应用到嵌入的问题或仪表板,请向iframe中链接的末尾添加一个query参数,如下所示
/dashboard/42?filter_name=value
例如,假设我们有一个具有“ID”过滤器的仪表板。我们可以将此过滤器设置为7
/dashboard/42?id=7
要将“ID”过滤器设置为7并从公共嵌入中隐藏“ID”过滤器小部件
/dashboard/42?id=7#hide_parameters=id
要指定多个过滤器的值,请使用“&”符号分隔这些值,如下所示
/dashboard/42?id=7&name=janet
您可以通过逗号分隔过滤器名称来隐藏多个过滤器小部件,如下所示
/dashboard/42#hide_parameters=id,customer_name
请注意,URL中过滤器的名称应指定为小写,并使用下划线而不是空格。如果您的过滤器名称为“用户ZIP代码过滤器”,则应写作
/dashboard/42?filter_for_user_zip_code=02116
禁用公共共享
默认情况下启用公共共享。
要禁用公共共享
- 单击右上角的齿轮图标。
- 选择管理设置。
- 在设置选项卡中,选择公共共享。
- 关闭公共共享。
一旦开启,公共共享部分将显示带有活动公共链接的Metabase问题、仪表板和操作。
如果您禁用公共共享,然后再次启用公共共享,您之前生成的所有公共链接仍然有效(只要您没有停用它们)。
停用公共链接和嵌入
单个问题或仪表板链接和嵌入
- 访问问题或仪表板。
- 单击共享图标。
- 选择公共链接或嵌入。
- 单击移除公共链接。
停用多个公共链接和嵌入
管理员可以查看并停用Metabase的所有公共链接。
- 单击右上角的齿轮图标。
- 选择管理设置。
- 转到设置选项卡。
- 在左侧侧边栏中转到公共共享选项卡。
- 对于您想要停用的每个项目,单击X撤销其公共链接。
查看所有公开共享的内容
管理员可以在管理设置 > 公共共享中查看所有公开共享的问题、仪表板和操作。
进一步阅读
阅读关于其他Metabase版本的文档。