雪花
要添加数据库连接,请点击右上角的齿轮图标,然后转到管理设置 > 数据库 > 添加数据库。
您可以在任何时候编辑这些设置。只需记得保存您的更改。
显示名称
数据库在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应用的服务器所在的时区。这对于小型数据库或经常更新的具有唯一值的表来说是最好的选择。
- 仅当添加新的过滤小部件时是一个很好的选择,如果您希望扫描查询按需运行。开启此选项意味着当在仪表板或SQL问题中添加新过滤器时,Metabase将仅扫描和缓存字段(s)的值。
- 从不,如果需要我将手动进行是针对那些要么过于庞大,要么实际上从未添加新值的数据库的选项。使用现在重新扫描字段值按钮运行手动扫描,并将过滤值更新到最新。
定期重新指纹表
定期重新指纹会增加您的数据库负载。
开启此选项以在每次Metabase运行同步时扫描值样本。
指纹查询检查每个列的前10,000行,并使用这些数据来估计每个列有多少唯一值,数字和时间戳列的最小值和最大值是多少,等等。如果您关闭此选项,Metabase将在设置期间仅对您的列进行一次指纹。
进一步阅读
阅读关于Metabase其他版本的文档。