Snowflake
要添加数据库连接,请点击右上角的齿轮图标,并导航至管理设置 > 数据库 > 添加数据库。
您可以随时编辑这些设置。只需记住保存您的更改。
显示名称
数据库在Metabase界面中显示的名称。
账户或主机名
您可以选择使用账户名称或主机名。您的主机名是数据库的IP地址或其域名(例如,database.example.com)。
如果您的URL包含数据库的区域,您可以使用账户名称连接,否则请使用主机名连接。
AWS
使用账户名称连接。
输入您的账户标识符以及 Snowflake 集群运行所在的区域。例如,xxxxxxxxx.us-east-3.aws
。例如,如果您在 AWS 上运行 Snowflake,并且您的账户 URL 是 https://az12345.ca-central-1.snowflakecomputing.com
<account_identifier>
:az12345.ca-central-1
。<cloud_platform>
:aws
。
您需要在 Metabase 中输入 az12345.ca-central-1.aws
作为账户名称。
并非所有区域都需要云平台标识符。如果您在 us-west-2
,您需要输入 az12345
作为账户名称。有关每个区域的要求,请参阅Snowflake 官方文档。
app.snowflake.com
使用主机名连接。
您可以通过转到 管理 > 账户 来获取您的主机名。“账户名称”将在“账户”下。点击您想使用的账户,然后点击链接图标以复制主机 URL:这就是您的主机名。在下图中,Metabot 谨慎地遮盖了敏感信息。右侧的“复制账户 URL”链接是您要查找的内容
了解更多关于Snowflake 中的账户标识符。
用户名
您想用于连接数据库的账户的数据库用户名。您可以使用不同的用户账户设置多个到同一数据库的连接,每个连接具有不同的权限集。
在您的 app.snowflake.com 账户页面上,您可以在 管理 > 用户和角色 下找到用户和角色。
密码
您用于连接数据库的用户名的密码。
RSA 私钥 (PEM)
非必需。您可以选择使用本地文件路径或上传文件路径。如果您在 Metabase Cloud 上,您需要选择上传文件路径并上传您的证书。
仓库
Snowflake 仓库。如果用户缺少默认仓库,您需要输入要连接的仓库。
在 app.snowflake.com 上,您可以在 管理 > 仓库 下找到仓库。
数据库名称(区分大小写)
您想在 Snowflake 中连接的数据库的名称。在 app.snowflake.com 上,您可以在 数据 > 数据库 下找到数据库。
架构(可选)
您可以指定您想要同步和扫描的架构。如果没有传递架构,则该用户和角色可用的所有架构都将作为 Metabase 中的文件夹列出。
架构选项包括
- 全部
- 仅限这些...
- 除以下之外的所有...
对于仅限这些和除以下之外的所有选项,您可以输入逗号分隔的值列表,以告知 Metabase 您想要包含(或排除)哪些架构。例如
FOO,BAR,BAZ
您可以使用 *
通配符来匹配多个架构。
假设您有三个架构:FOO、BAR 和 BAZ。
- 如果您设置了仅限这些...,并输入字符串
B*
,您将与 bar 和 baz 同步。 - 如果您设置了除以下之外的所有...,并输入字符串
B*
,您将只同步 foo。
请注意,仅支持 *
通配符;您不能使用其他特殊字符或正则表达式。
角色(可选)
指定一个角色以覆盖数据库用户的默认角色。例如,如果数据库用户 METABASE
具有以下角色
- 默认角色
APPLICATION
。 - 附加角色
ANALYTICS
。
您可以在“角色”字段中输入 ANALYTICS
,以确保 METABASE
用户默认使用 ANALYTICS
角色连接到 Snowflake。
使用 SSH 隧道
请参阅我们的 SSH 隧道指南。
其他 JDBC 连接字符串选项
某些数据库允许您将选项附加到 Metabase 用于连接数据库的连接字符串。
为简单探索重新运行查询
如果用户希望在应用任何汇总或筛选条件之前点击运行(播放按钮),请将此选项关闭。
默认情况下,当您从“汇总”菜单中选择分组选项或从钻取菜单中选择筛选条件时,Metabase 将立即执行查询。如果您的数据库速度较慢,您可能希望禁用重新运行以避免每次点击都加载数据。
选择 Metabase 同步和扫描的时间
开启此选项以管理 Metabase 用于与数据库保持同步的查询。有关更多信息,请参阅同步和扫描数据库。
数据库同步
如果您选择了选择同步和扫描发生的时间 > 开启,您将能够设置
- 同步的频率:每小时(默认)或每天。
- 同步运行的时间,以运行 Metabase 应用的服务器的时区为准。
扫描筛选器值
Metabase 可以扫描此数据库中每个字段中存在的值,以在仪表板和问题中启用复选框筛选器。这可能是一个相当消耗资源的过程,特别是当您有一个非常大的数据库时。
如果您选择了选择同步和扫描发生的时间 > 开启,您将在扫描筛选器值下看到以下选项
- 定期,按计划允许您以与数据库更改速率匹配的频率运行扫描查询。时间以运行 Metabase 应用的服务器的时区为准。对于小型数据库或具有经常更新的不同值的表,这是最佳选择。
- 仅在添加新的筛选器小部件时,如果您希望按需运行扫描查询,这是一个不错的选择。开启此选项意味着 Metabase 将仅扫描和缓存在向仪表板或 SQL 问题添加新筛选器时使用的字段的值。
- 从不,如果需要,我会手动执行此操作,对于数据库非常大或几乎没有添加新值的情况,这是一个选项。使用立即重新扫描字段值按钮运行手动扫描并将您的筛选器值更新到最新状态。
定期重新指纹表
定期重新指纹识别将增加数据库的负载。
开启此选项,以便在 Metabase 每次运行同步时扫描值的样本。
指纹识别查询会检查每列的前 10,000 行,并使用该数据来估算每列有多少个唯一值,数值列和时间戳列的最小值和最大值等等。如果您将此选项关闭,Metabase 将仅在设置期间对您的列进行一次指纹识别。
延伸阅读
阅读其他Metabase 版本的文档。