PostgreSQL
要添加数据库连接，请单击右上角的 齿轮 图标，然后转到 管理设置 > 数据库 > 添加数据库。
填写该数据库的字段，并在底部单击 保存更改。
设置
您可以在任何时间编辑这些设置。请记住保存您的更改。
显示名称
在 Metabase 界面中数据库的显示名称。
主机
您的数据库的 IP 地址，或其域名（例如，esc.mydatabase.com）。
端口
数据库端口。例如，5432。
数据库名称
您要连接到的数据库名称。
用户名
您要使用以连接到数据库的数据库用户名。您可以使用不同的用户账户设置多个连接到同一数据库，每个账户都有不同的权限。
密码
您用于连接到数据库的用户名的密码。
使用身份验证提供程序
除了密码外，您还可以使用支持的提供程序进行身份验证。
仅适用于自托管的 Pro 和企业计划。
Azure 管理标识
要使用 Azure 管理标识，您需要输入您的客户端 ID。
Oauth
要使用 Oauth 作为提供程序，您需要输入您的
- 认证令牌 URL
- 认证令牌请求头（JSON 映射）
模式
您可以指定您想要同步和扫描的模式。选项包括
- 全部
- 仅这些...
- 全部除了...
对于仅这些...和全部除了...选项，您可以输入逗号分隔的值列表，以告诉 Metabase 您想要包含（或排除）哪些模式。例如
foo,bar,baz
您可以使用 * 通配符来匹配多个模式。
假设您有三个模式：foo、bar 和 baz。
- 如果您设置了 仅这些...，并输入字符串
b*，您将同步 bar 和 baz。 - 如果您设置了 全部除了...，并输入字符串
b*，您将只同步 foo。
注意，仅支持 * 通配符；您不能使用其他特殊字符或正则表达式。
使用安全连接（SSL）
Metabase 会自动尝试使用 SSL 连接到数据库，如果不起作用，则不使用 SSL。如果可以通过 SSL 连接连接到您的数据库，Metabase 将将其作为默认设置。如果您希望在不使用此安全层的情况下连接，您可以稍后更改此设置，但我们强烈建议保持 SSL 开启以保持您的数据安全。
SSL 模式
PostgreSQL 数据库支持不同级别的安全性和连接，具有不同的开销。
SSL 模式选项包括
- 允许
- 优先
- 要求
- 验证 CA
- 完整验证
请参阅 PostgreSQL 文档中的有关不同SSL 模式的表格，并选择适合您的选项。
SSL 根证书（PEM）
如果您将SSL模式设置为“verify-ca”或“verify-full”，则需要指定一个根证书（PEM）。您可以选择使用一个本地文件路径或一个上传文件路径。如果您使用Metabase Cloud，则需要选择上传文件路径并上传您的证书。
验证客户端证书
开启以显示客户端证书选项。
SSL客户端证书（PEM）
您可以选择使用一个本地文件路径或一个上传文件路径。如果您使用Metabase Cloud，则需要选择上传文件路径并上传您的证书。
SSL客户端密钥（PKCS-8/DER）
同样，您可以选择使用一个本地文件路径或一个上传文件路径。如果您使用Metabase Cloud，则需要选择上传文件路径并上传您的证书。您还需要输入您的SSL客户端密钥密码。
私钥必须是PKCS8格式，并存储在DER格式中。
如果您有PEM SSL客户端密钥，可以使用openssl将其转换为PKCS-8/DER格式。命令可能如下所示
openssl pkcs8 -topk8 -inform PEM -outform DER -in client-key.pem -out client-key.der -nocrypt
注意：如果您使用GCP并成功签发了客户端证书，所有内容都将以PEM格式提供，您只需将client-key.pem转换为client-key.der以用于“SSL客户端密钥”
使用SSH隧道
请参阅我们关于SSH隧道的指南。
高级设置
展开JSON列
对于PostgreSQL数据库，Metabase可以将JSON列展开为组件字段，从而生成一个表格，其中每个JSON键都成为一列。JSON展开默认开启，但您可以根据性能需要关闭JSON展开。
如果您启用了JSON展开，您还可以在表格元数据中切换单个列的展开。
额外的JDBC连接字符串选项
您可以将选项附加到Metabase用于连接到您的数据库的连接字符串。使用以下格式
options=-c%20key=value
PostgreSQL连接URI期望使用百分号编码来表示空白和符号。
重新运行查询进行简单探索
如果您希望用户在应用任何汇总或筛选选择之前先点击运行（播放按钮），请将此选项关闭。
默认情况下，Metabase将在您从汇总菜单中选择分组选项或从钻取菜单中选择筛选条件时立即执行查询。如果您的数据库较慢，您可能希望禁用重新运行以避免每次点击都加载数据。
选择Metabase同步和扫描的时间
将此选项开启以管理Metabase用于保持与数据库同步的查询。有关更多信息，请参阅同步和扫描数据库。
数据库同步
如果您已选择选择同步和扫描发生的时间 > 开启，您将能够设置
- 同步的频率：每小时（默认）或每天。
- 同步运行的时间，以运行Metabase应用的服务器所在的时区为准。
扫描筛选值
Metabase可以扫描数据库中每个字段现有的值，以便在仪表板和问题中启用复选框筛选。这可能是一个资源密集型的过程，尤其是如果您有一个非常大的数据库。
如果您已选择选择同步和扫描发生的时间 > 开启，您将在扫描筛选值下看到以下选项
- 定期，按照计划可以让您以与数据库更改频率相匹配的频率运行扫描查询。时间设置为运行Metabase应用程序的服务器所在的时区。这对于小型数据库或经常更新的具有不同值的表来说，是最佳选项。
- 仅在添加新过滤器小部件时，如果想要按需运行扫描查询，这是一个很好的选项。将此选项打开意味着Metabase将在向仪表板或SQL问题添加新过滤器时，只扫描和缓存所使用的字段（字段）的值。
- 从不，如果需要我会手动进行是针对那些要么太大无法承受，要么根本不添加新值的数据库的选项。使用立即重新扫描字段值按钮来运行手动扫描并更新筛选值。
定期重新指纹表格
定期重新指纹将增加数据库的负载。
将此选项打开，以便每次Metabase运行同步时扫描值样本。
指纹查询检查每个列的前10,000行，并使用这些数据来估计每个列有多少唯一值，对于数值和日期时间列，最小和最大值是多少等。如果您将此选项关闭，Metabase将在设置期间仅对列进行一次指纹。
进一步阅读
阅读Metabase其他版本的文档。