Snowflake
要添加数据库连接,请点击右上角的齿轮图标,然后导航到管理设置 > 数据库 > 添加数据库。
您可以随时编辑这些设置。请记住保存您的更改。
显示名称
数据库在 Metabase 界面中的显示名称。
账户或主机名
您可以选择使用账户名或主机名。您的主机名是数据库的 IP 地址或域名(例如,database.example.com)。
如果您的 URL 包含数据库的区域,您可以使用账户名连接,否则请使用主机名连接。
AWS
使用账户名连接。
输入您的账户标识符和 Snowflake 集群运行的区域。例如,xxxxxxxxx.us-east-3.aws
。例如,如果您在 AWS 上运行 Snowflake 并且您的账户 URL 是 https://az12345.ca-central-1.snowflakecomputing.com
<账户标识符>
:az12345.ca-central-1
。<云平台>
: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 会获取您在 Snowflake 中授予该用户所有角色组合后的所有权限。在此设置“角色”只是将角色添加到连接字符串以告诉 Snowflake 默认使用哪个角色——它不会自行限制访问。因此,请务必谨慎分配连接用户角色:如果以后您在 Snowflake 中授予该用户更广泛的角色,Metabase 将自动获取这些新权限,可能会显示您不希望其看到的数据。如果相反,您希望 Metabase 在查询任何内容之前发出
SET ROLE
命令,请查看连接模拟。
指定一个角色以覆盖数据库用户的默认角色。例如,如果数据库用户 METABASE
具有以下角色
- 默认角色
APPLICATION
。 - 附加角色
ANALYTICS
。
您可以在“角色”字段中输入 ANALYTICS
,以确保 METABASE
用户默认使用 ANALYTICS
角色连接到 Snowflake。
使用 SSH 隧道
请参阅我们的 SSH 隧道指南。
其他 JDBC 连接字符串选项
某些数据库允许您将选项附加到 Metabase 用于连接到数据库的连接字符串中。
重新运行简单探索查询
如果用户希望在应用任何汇总或筛选条件之前点击运行(播放按钮),请将此选项设置为关闭。
默认情况下,Metabase 会在您从汇总菜单中选择分组选项或从钻取菜单中选择筛选条件时立即执行查询。如果您的数据库运行缓慢,您可能需要禁用重新运行以避免每次点击都加载数据。
选择同步和扫描发生的时间
请参阅 同步和扫描。
定期重新指纹识别表格
定期重新指纹识别会增加数据库的负载。
将此选项设置为开,以便 Metabase 每次运行同步时扫描值的样本。
指纹查询检查每列的前 10,000 行,并使用该数据估算每列的唯一值数量、数字和时间戳列的最小值和最大值等。如果将此选项设置为关,Metabase 将只在设置期间对列进行一次指纹识别。
模型功能
Snowflake 尚无(目前)可用的模型功能。
数据库路由
请参阅 数据库路由。
危险区
请参阅 危险区。
延伸阅读
阅读其他 Metabase 版本的文档。