文档Experience Platform 联合受众构成

配置联合数据库 federated-db

Last update: Thu Nov 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Experience Platform 联合受众构成允许客户从第三方数据仓库构建和扩充受众，并将受众导入到 Adobe Experience Platform 中。

在此页面中了解如何创建、配置、测试和保存与外部数据库的连接。您可以在下面找到受支持的数据库列表以及每个数据库需要配置的详细设置。

支持的数据库 supported-db

通过联合受众构成，您可以连接到以下数据库。每个数据库的配置详细说明如下。

Amazon Redshift amazon-redshift

使用联合数据库处理存储在外部数据库中的信息。按照以下步骤配置对 Amazon Redshift 的访问权限。

  1. 在​ 联合数据 ​菜单下，选择​ 联合数据库。

  2. 单击​ 添加联合数据库。

  3. 为您的联合数据库输入一个​ 名称。

  4. 从​ 类型 ​下拉菜单中，选择 Amazon Redshift。

  5. 配置 Amazon Redshift 身份验证设置：

    • 服务器：添加 DNS 的名称。

    • 帐户：添加用户名。

    • 密码：添加账号密码。

    • 数据库：数据库的名称（如果未在 DSN 中指定）。如果已在 DSN 中指定，则可以将其留空

    • 工作模式：用于工作表的数据库模式的名称。请在 Amazon 文档中了解详情

      note note
      NOTE
      您可以使用数据库中的任何模式，包括用于临时数据处理的模式，只要您具有连接到此模式所需的权限即可。
      当使用同一个数据库连接多个沙盒时，必须使用​ 不同的工作模式。

  6. 选择​ 测试连接 ​选项来验证您的配置。

  7. 点击​ 部署功能 ​按钮来创建函数。

  8. 配置完成后，点击​ 添加 ​创建您的联合数据库。

Azure Synapse Analytics azure-synapse

使用联合数据库处理存储在外部数据库中的信息。按照以下步骤配置对 Azure Synapse Analytics 的访问权限。

  1. 在​ 联合数据 ​菜单下，选择​ 联合数据库。

  2. 单击​ 添加联合数据库。

  3. 为您的联合数据库输入一个​ 名称。

  4. 在​ 类型 ​下拉菜单中选择 Azure Synapse Analytics。

  5. 配置 Azure Synapse Analytics 身份验证设置：

    • 服务器：输入 Azure Synapse 服务器的 URL。

    • 帐户：输入用户名。

    • 密码：输入账号密码。

    • 数据库 （可选）：如果 DSN 中未指定，请输入数据库的名称。

    • 选项：该连接器支持下表中详述的选项。

  6. 选择​ 测试连接 ​选项来验证您的配置。

  7. 点击​ 部署功能 ​按钮来创建函数。

  8. 配置完成后，点击​ 添加 ​创建您的联合数据库。

选项
描述
身份验证
连接器支持的身份验证类型。当前支持的值：ActiveDirectoryMSI。有关详细信息，请参阅 Microsoft SQL 文档（示例连接字符串 n°8）

Google Big Query google-big-query

使用联合数据库处理存储在外部数据库中的信息。按照以下步骤配置对 Google Big Query 的访问权限。

  1. 在​ 联合数据 ​菜单下，选择​ 联合数据库。

  2. 单击​ 添加联合数据库。

  3. 为您的联合数据库输入一个​ 名称。

  4. 在​ 类型 ​下拉菜单中，选择 Google Big Query。

  5. 配置 Google Big Query 身份验证设置：

    • 服务帐户：输入您的电子邮件​ 服务帐户。有关更多信息，请参阅 Google Cloud 文档。

    • 项目：输入您的​ 项目 的 ID。有关更多信息，请参阅 Google Cloud 文档。

    • 数据集：输入您的​ 数据集 ​的名称。有关更多信息，请参阅 Google Cloud 文档。

    • 密钥文件路径：将您的密钥文件上传到服务器。仅接受 .json 文件。

    • 选项：该连接器支持下表中详述的选项。

  6. 选择​ 测试连接 ​选项来验证您的配置。

  7. 点击​ 部署功能 ​按钮来创建函数。

  8. 配置完成后，点击​ 添加 ​创建您的联合数据库。

选项
描述
ProxyType
用于通过 ODBC 和 SDK 连接器连接到 BigQuery 的代理类型。
目前支持 HTTP（默认）、http_no_tunnel、socks4 和 socks5。
ProxyHost
可以访问代理的主机名或 IP 地址。
ProxyPort
代理运行的端口号，例如 8080
ProxyUid
用于经过身份验证的代理的用户名
ProxyPwd
ProxyUid 密码
bqpath
请注意，这仅适用于批量加载工具 (Cloud SDK)。
为了避免使用 PATH 变量或者如果必须将 google-cloud-sdk 目录移动到其他位置，您可以使用此选项指定服务器上 cloud sdk bin 目录的确切路径。
GCloudConfigName
请注意，这适用于从版本 7.3.4 开始的版本，并且仅适用于批量加载工具 (Cloud SDK)。
Google Cloud SDK 使用配置将数据加载到 BigQuery 表中。名为 accfda 的配置存储加载数据的参数。但是，此选项允许用户为配置指定不同的名称。
GCloudDefaultConfigName
请注意，这适用于从版本 7.3.4 开始的版本，并且仅适用于批量加载工具 (Cloud SDK)。
如果不先将活动标记转移到新配置，则无法删除活动的 Google Cloud SDK 配置。此临时配置对于重新创建用于加载数据的主要配置是必要的。临时配置的默认名称是 default，如果需要，该名称可以进行更改。
GCloudRecreateConfig
请注意，这适用于从版本 7.3.4 开始的版本，并且仅适用于批量加载工具 (Cloud SDK)。
当设置为 false 时，批量加载机制不会尝试重新创建、删除或修改 Google Cloud SDK 配置。相反，它会使用机器上现有的配置继续加载数据。当其他操作依赖于 Google Cloud SDK 配置时，此功能很有价值。
如果用户在没有正确配置的情况下启用此引擎选项，则批量加载机制会发出警告消息： No active configuration found. Please either create it manually or remove the GCloudRecreateConfig option。为了防止进一步出现错误，它将会恢复使用默认的 ODBC 数组插入批量加载机制。

Snowflake snowflake

NOTE
支持通过私有链接安全访问您的外部 Snowflake Data Warehouse。请注意，您的 Snowflake 帐户必须在 Amazon Web Services (AWS) 上托管，并且与您的联合受众构成环境位于同一区域。请联系您的 Adobe 代表，以获取有关设置 Snowflake 帐户安全访问权限的帮助。

使用联合数据库处理存储在外部数据库中的信息。执行以下步骤来配置对 Snowflake 的访问权限：

  1. 在​ 联合数据 ​菜单下，选择​ 联合数据库。

  2. 单击​ 添加联合数据库。

  3. 为您的联合数据库输入一个​ 名称。

  4. 在​ 类型 ​下拉菜单中，选择 Snowflake。

  5. 配置 Snowflake 身份验证设置：

    • 服务器：输入您的服务器名称。

    • 用户：输入您的用户名。

    • 密码：输入您的帐户密码。

    • 数据库 （可选）：如果 DSN 中未指定，请输入数据库的名称。

    • 工作模式（可选）：输入用于工作表的数据库模式的名称。

      note note
      NOTE
      您可以使用数据库中的任何模式，包括用于临时数据处理的模式，只要您具有连接到此模式所需的权限即可。
      当使用同一个数据库连接多个沙盒时，必须使用​ 不同的工作模式。

    • 私钥：点击​ 私钥 ​字段，从您的区域设置文件夹中选择您的 .pem 文件。

    • 选项：该连接器支持下表中详述的选项。

  6. 选择​ 测试连接 ​选项来验证您的配置。

  7. 点击​ 部署功能 ​按钮来创建函数。

  8. 配置完成后，点击​ 添加 ​创建您的联合数据库。

该连接器支持以下选项：

选项
描述
workschema
用于工作表的数据库模式
仓库
默认使用的数据仓库名称。它将会覆盖用户的默认值。
TimeZoneName
默认为空，表示使用的是应用程序服务器的系统时区。该选项可用于强制使用 TIMEZONE 会话参数。
有关详细信息，请参见此页面。
WeekStart
WEEK_START 会话参数。默认设置为 0。
有关详细信息，请参见此页面。
UseCachedResult
USE_CACHED_RESULTS 会话参数。默认设置为真。此选项可用于禁用 Snowflake 缓存结果。
有关详细信息，请参见此页面。
bulkThreads
用于 Snowflake 批量加载器的线程数，线程越多，对于更大的批量加载，性能就越好。默认设置为 1。可以根据机器线程数调整数量。
chunkSize
确定批量加载器块的文件大小。默认设置为 128MB。与 bulkThreads 一起使用时，可以进行修改，以获得更优化的性能。更多并发活动线程意味着性能更佳。
有关更多信息，请参阅 Snowflake 文档。
StageName
预配置内部阶段的名称。它将会用于批量加载，而不是创建新的临时阶段。

Vertica Analytics vertica-analytics

使用联合数据库处理存储在外部数据库中的信息。按照以下步骤配置对 Vertica Analytics 的访问权限。

  1. 在​ 联合数据 ​菜单下，选择​ 联合数据库。

  2. 单击​ 添加联合数据库。

  3. 为您的联合数据库输入一个​ 名称。

  4. 在​ 类型 ​下拉菜单中，选择 Vertica Analytics。

  5. 配置 Vertica Analytics 身份验证设置：

    • 服务器：添加 Vertica Analytics 服务器的 URL。

    • 帐户：添加用户名。

    • 密码：添加账号密码。

    • 数据库 （可选）：如果 DSN 中未指定，请输入数据库的名称。

    • 工作模式（可选）：输入用于工作表的数据库模式的名称。

      note note
      NOTE
      您可以使用数据库中的任何模式，包括用于临时数据处理的模式，只要您具有连接到此模式所需的权限即可。
      当使用同一个数据库连接多个沙盒时，必须使用​ 不同的工作模式。

    • 选项：该连接器支持下表中详述的选项。

  6. 选择​ 测试连接 ​选项来验证您的配置。

  7. 点击​ 部署功能 ​按钮来创建函数。

  8. 配置完成后，点击​ 添加 ​创建您的联合数据库。

该连接器支持以下选项：

选项
描述
TimeZoneName
默认为空，表示使用的是应用程序服务器的系统时区。该选项可用于强制使用 TIMEZONE 会话参数。

数据块 databricks

使用联合数据库处理存储在外部数据库中的信息。执行以下步骤来配置对 Databricks 的访问权限。

  1. 在​ 联合数据 ​菜单下，选择​ 联合数据库。

  2. 单击​ 添加联合数据库。

  3. 为您的联合数据库输入一个​ 名称。

  4. 在​ 类型 ​下拉菜单中，选择 Databricks。

  5. 配置 Databricks 身份验证设置：

    • 服务器：添加您的 Databricks 服务器的名称。

    • HTTP 路径：将路径添加到您的群集或仓库中。了解详情

    • 密码：添加帐户访问令牌。了解详情

    • 目录：为 Databricks 目录添加字段。

    • 工作模式：用于工作表的数据库模式的名称。

      note note
      NOTE
      您可以使用数据库中的任何模式，包括用于临时数据处理的模式，只要您具有连接到此模式所需的权限即可。
      当使用同一个数据库连接多个沙盒时，必须使用​ 不同的工作模式。

    • 选项：该连接器支持下表中详述的选项。

  6. 选择​ 测试连接 ​选项来验证您的配置。

  7. 点击​ 部署功能 ​按钮来创建函数。

  8. 配置完成后，点击​ 添加 ​创建您的联合数据库。

该连接器支持以下选项：

选项
描述
TimeZoneName
默认为空，表示使用的是应用程序服务器的系统时区。该选项可用于强制使用 TIMEZONE 会话参数。
recommendation-more-help
fadff0d9-29d0-4d44-99a6-2499b0b7778b