创建连接 connections-fdb

AVAILABILITY
要访问连接,您需要以下权限之一:
-管理联合数据库
-查看联合数据库
有关所需权限的更多信息,请阅读访问控制指南

Experience Platform联合受众构成允许您从第三方数据仓库构建和丰富受众,并将受众导入到Adobe Experience Platform。

支持的数据库 supported-databases

要使用联合数据库和Adobe Experience Platform,必须首先在这两个源之间建立连接。 使用联合受众合成,您可以连接到以下数据库。

  • Amazon Redshift
  • Azure Synapse Analytics
  • 数据块
  • Google BigQuery
  • Microsoft Fabric
  • Oracle
  • Snowflake
  • Vertica Analytics

创建连接 create

要创建连接,请在联合数据部分中选择​联合数据库

左侧导航中突出显示“联合数据库”按钮。 {align="center" width="70%" modal="regular"}

此时将显示“联合数据库”部分。 选择​ 添加联合数据库 ​以创建连接。

“添加联合数据库”按钮在“联合数据库”显示页中突出显示。 {align="center" width="70%" modal="regular"}

出现“connection properties(连接属性)”弹出框。 您可以命名连接并选择要创建哪种类型的数据库。

显示联合数据库类型。 {align="center" width="70%" modal="regular"}

选择类型后,将显示​ 详细信息 ​部分。 此部分根据之前选择的数据库类型而有所不同。

Amazon Redshift
note availability
AVAILABILITY
仅支持Amazon Redshift AWS、Amazon Redshift Spectrum和Amazon Redshift Serverless。
此外,支持通过专用链接安全访问外部Amazon Redshift数据仓库。

选择Amazon Redshift后,您可以添加以下详细信息:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
字段 描述
Server 数据源的名称。
帐户 帐户的用户名。
密码 帐户的密码。
数据库 数据库的名称。 如果在服务器名称中指定此字段,可将此字段留空。
工作模式 用于工作表的数据库模式的名称。 有关此功能的更多信息,请参阅Amazon架构文档

注意:​您可以使用数据库中的任何架构,包括用于临时数据处理的架构,只要您具有连接到此架构所需的权限。 但是,在使用同一数据库连接多个沙盒时,必须​使用不同的工作架构。
Azure Synapse Analytics
note note
NOTE
如果要使用Azure Synapse Analytics创建安全连接,请联系您的Adobe客户关怀代表。

选择Azure Synapse Analytics后,您可以添加以下详细信息:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
字段 描述
Server Azure Synapse服务器的URL。
帐户 Azure应用程序注册的应用程序ID (客户端ID)。
密码 Azure应用程序的​ 客户端密钥 ​值。
数据库 数据库的名称。 如果在服务器名称中指定此字段,可将此字段留空。
选项 用于连接的其他选项。 对于Azure Synapse Analytics,您可以指定连接器支持的身份验证类型。 目前,联合受众组合支持ActiveDirectoryMSI。 有关连接字符串的更多信息,请参阅Microsoft文档中的示例连接字符串部分。

或者,您也可以使用服务主体身份验证安全地配置Azure Synapse Analytics连接。 您应该将服务主体身份验证用于生产级集成以及自动化方案。

accordion
先决条件

在设置服务主体身份验证之前,请注意以下先决条件:

  • 有权访问Microsoft Entra ID的Azure订阅
  • Azure Synapse工作区和数据库
  • 创建应用程序注册的权限
  • 管理Azure Synapse数据库角色的权限
  • 更新联合数据库配置的权限

在Azure Portal中,你首先需要创建新的应用程序注册。 在为应用程序指定唯一名称后,选择​注册。 此时会显示​ 概述 ​页面。 确保记下​ 应用程序(客户端) ID ​和​ 目录(租户) ID ​值。

概述页面中的应用程序(客户端)ID已突出显示。

在新注册的应用程序中,选择​证书和密钥。 在此处,选择​ 客户端密钥 ​部分中的​ 新建客户端密钥 ​以创建新的客户端密钥。 提供说明并过期后,选择​ 添加 ​以生成客户端密钥。

note important
IMPORTANT
生成客户端密钥后,复制并安全存储您的​客户端密钥值。 此值将​ ​再次可见。

现在您已生成客户端密钥,您需要确保已将​ 服务主体 ​身份授予资源。

有关将标识分配给资源的详细信息,请阅读Azure Synapse Analytics托管标识指南

由于您已完成所有Azure端配置,因此现在可以设置联合受众合成端配置。

在Azure Synapse连接中,设置以下配置详细信息:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
字段 描述
Server Azure Synapse服务器的URL。
帐户 Azure应用程序注册的应用程序ID (客户端ID)。
密码 Azure应用程序的​ 客户端密钥 ​值。
数据库 数据库的名称。 如果在服务器名称中指定此字段,可将此字段留空。
选项 用于连接的其他选项。 若要使用服务主体身份验证,您需要设置Authentication="ActiveDirectoryServicePrincipal"
数据库
note note
NOTE
支持通过私有链接安全访问您的外部 Databricks 数据仓库。这包括通过私有链接与 Amazon Web Services (AWS) 上托管的 Databricks 数据库建立安全连接,以及通过 VPN 与 Microsoft Azure 上托管的 Databricks 数据库建立安全连接。请联系您的 Adobe 代表,以获取有关设置安全访问权限的帮助。

选择数据库后,您可以添加以下详细信息:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
字段 描述
Server Databricks服务器的名称。
HTTP 路径 群集或仓库的路径。 有关路径的详细信息,请阅读有关连接详细信息数据库文档。
密码 数据库服务器的访问令牌。 有关此值的更多信息,请阅读有关个人访问令牌的数据库文档
Catalog 数据库目录的名称。 有关数据库目录的详细信息,请阅读有关目录数据库文档
工作模式 用于工作表的数据库模式的名称。

注意:​您可以从数据库使用​ any ​架构,包括用于临时数据处理的架构,只要您具有连接到此架构所需的权限。 但是,在使用同一数据库连接多个沙盒时,必须​使用不同的工作架构。
选项 用于连接的其他选项。 下表列出了可用的选项。

对于数据库,可以设置以下附加选项:

table 0-row-2 1-row-2
选项 描述
TimeZoneName 要使用的时区的名称。 此值表示TIMEZONE会话参数。 有关时区的详细信息,请阅读关于时区的Databricks文档
Google BigQuery
note note
NOTE
支持通过VPN安全访问外部Google BigQuery Data Warehouse。

选择Google BigQuery后,您可以选择在与联合受众构成连接时要使用的身份验证方法。

如果选择​帐户/密码身份验证,则可以添加以下登录信息:

table 0-row-2 1-row-2
字段 描述
服务帐户 服务帐户的电子邮件地址。 有关详细信息,请阅读Google Cloud Service帐户文档

如果选择​OAuth 2.0,则可以添加以下登录信息:

note note
NOTE
在使用OAuth 2.0连接到Google BigQuery之前,您需要在Google Cloud项目中配置重定向URL。 在OAuth 2.0客户端ID配置下,将重定向URL https://fac-oauth.adobe.io/oauth添加到您的Google Cloud项目。
table 0-row-2 1-row-2 2-row-2 3-row-2
字段 描述
客户端 ID Google BigQuery项目中的客户端ID。 此字段充当项目的用户名。
客户端密码 Google BigQuery项目的客户端密钥。 此字段充当项目的密码。
访问范围 预填充的信息,该信息列出您的OAuth令牌在Google云资源中有权使用的范围。

选择​ 登录 ​以完成您的身份验证。

输入登录详细信息后,您可以添加以下详细信息:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
字段 描述
项目 项目的ID。 有关详细信息,请阅读Google Cloud项目文档
数据集 数据集的名称。 有关详细信息,请参阅Google Cloud数据集文档
密钥文件路径 到服务器的密钥文件。 仅支持json个文件。
选项 用于连接的其他选项。 下表列出了可用的选项。

对于Google BigQuery,您可以设置以下附加选项:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
选项 描述
ProxyType 用于连接到BigQuery的代理的类型。 支持的值包括HTTPhttp_no_tunnelsocks4socks5
ProxyHost 可访问代理的主机名或IP地址。
ProxyUid 运行代理的端口号。
ProxyPwd 代理的密码。
bgpath 注意:​这仅适用于​批量加载工具 (Cloud SDK)。

服务器上云SDK bin目录的路径。 只有在已将google-cloud-sdk目录移动到其他位置或要避免使用PATH变量时,才需要设置此项。
GCloudConfigName 注意:​这仅适用于7.3.4以上版本的​批量加载工具 (Cloud SDK)。

存储用于加载数据的参数的配置名称。 默认情况下,此值为accfda
GCloudDefaultConfigName 注意:​这仅适用于7.3.4以上版本的​批量加载工具 (Cloud SDK)。

为重新创建用于加载数据的主配置的临时配置的名称。 默认情况下,此值为default
GCloudRecreateConfig 注意:​这仅适用于7.3.4以上版本的​批量加载工具 (Cloud SDK)。

一个布尔值,可让您决定批量加载机制是否应自动重新创建、删除或修改Google Cloud SDK配置。 如果此值设置为false,则批量加载机制将使用计算机上的现有配置来加载数据。 如果此值设置为true,请确保您的配置设置正确 — 否则,将显示No active configuration found. Please either create it manually or remove the GCloudRecreateConfig option错误,加载机制将还原为默认的加载机制。
Microsoft结构

选择Microsoft Fabric后,您可以添加以下详细信息:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
字段 描述
Server Microsoft Fabric服务器的URL。
应用程序Id Microsoft结构的应用程序ID。 有关应用程序ID的详细信息,请阅读有关应用程序设置Microsoft Fabric文档。
客户端密码 应用程序的客户端密码。 有关客户端密钥的详细信息,请阅读有关应用程序设置Microsoft Fabric文档。
选项 用于连接的其他选项。 下表列出了可用的选项。

对于Microsoft Fabric ,可以设置以下附加选项:

table 0-row-2 1-row-2
选项 描述
身份验证 连接器使用的身份验证类型。 支持的值包括: ActiveDirectoryMSI。 有关详细信息,请阅读有关仓库连接的Microsoft文档
Oracle
note note
NOTE
联合受众组合支持联合连接设置,该连接设置可与11g或更高版本上的Oracle数据库配合使用,并托管在AWS、Azure、Exadata或私有云上(只要该数据库可由外部网络访问)。 如果您有与Oracle数据库设置相关的任何进一步查询或需要创建与Oracle的安全连接,请联系您的Adobe客户关怀代表。

选择Oracle后,您可以添加以下详细信息:

table 0-row-2 1-row-2 2-row-2 3-row-2
字段 描述
Server Oracle服务器的URL。
帐户 帐户的用户名。
密码 帐户的密码。
Snowflake
note note
NOTE
支持通过私有链接安全访问您的外部 Snowflake Data Warehouse。请注意,您的 Snowflake 帐户必须在 Amazon Web Services (AWS) 或 Azure 上托管,并且与您的联合受众构成环境位于同一区域。请联系您的 Adobe 代表,以获取有关设置 Snowflake 帐户安全访问权限的帮助。

选择Snowflake后,您可以选择在与联合受众构成连接时要使用的身份验证方法。

如果选择​帐户/密码身份验证,则可以添加以下登录信息:

table 0-row-2 1-row-2 2-row-2 3-row-2
字段 描述
Server 服务器的名称。
用户 帐户的用户名。
密码 帐户的密码。

如果选择​OAuth 2.0,则可以添加以下登录信息:

note note
NOTE
在使用OAuth 2.0连接到Snowflake之前,您需要在Snowflake OAuth集成对象中配置重定向URL。 将重定向URL https://fac-oauth.adobe.io/oauth添加到您的Snowflake OAuth集成配置。
table 0-row-2 1-row-2 2-row-2 3-row-2
字段 描述
Server 服务器的名称。
客户端 ID Snowflake项目中的客户端ID。 此字段充当项目的用户名。
客户端密码 Snowflake项目中的客户端密钥。 此字段充当项目的密码。

选择​ 登录 ​以完成您的身份验证。

输入登录详细信息后,您可以添加以下详细信息:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
字段 描述
数据库 数据库的名称。 如果在服务器名称中指定此字段,可将此字段留空。
工作模式 用于工作表的数据库模式的名称。

注意:​您可以从数据库使用​ any ​架构,包括用于临时数据处理的架构,只要您具有连接到此架构所需的权限。 但是,在使用同一数据库连接多个沙盒时,必须​使用不同的工作架构。
私钥 数据库连接的私钥。 您可以从本地系统上传.pem文件。
选项 用于连接的其他选项。 下表列出了可用的选项。

对于Snowflake,您可以设置以下其他选项:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
选项 描述
workschema 用于工作表的数据库模式的名称。
TimeZoneName 要使用的时区的名称。 此值表示TIMEZONE会话参数。 默认情况下,将使用系统时区。 有关时区的更多信息,请阅读Snowflake关于时区的文档
WeekStart 您希望一周开始的那一天。 此值表示WEEK_START会话参数。 有关周开始的详细信息,请阅读有关周开始参数Snowflake文档
UseCachedResult 一个布尔值,确定是否使用Snowflake缓存的结果。 此值表示USE_CACHED_RESULTS会话参数。 默认情况下,此值设置为true。 有关此参数的更多信息,请阅读有关保留结果Snowflake文档。
bulkThreads 用于Snowflake批量加载器的线程数。 添加线程越多,批量负载越大,性能越好。 默认情况下,此值设置为1。
chunkSize 每个批量加载程序块的文件大小。 与更多线程同时使用时,您可以提高批量加载的性能。 默认情况下,此值设置为128 MB。 有关区块大小的更多信息,请阅读有关准备数据文件的Snowflake文档
StageName 预配置的内部暂存环境的名称。 这可用于批量加载,而不是创建新的临时阶段。
Vertica Analytics

选择Vertica Analytics后,您可以添加以下详细信息:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
字段 描述
Server Vertica Analytics服务器的URL。
帐户 帐户的用户名。
密码 帐户的密码。
数据库 数据库的名称。 如果在服务器名称中指定此字段,可将此字段留空。
工作模式 用于工作表的数据库模式的名称。

注意:​您可以从数据库使用​ any ​架构,包括用于临时数据处理的架构,只要您具有连接到此架构所需的权限。 但是,在使用同一数据库连接多个沙盒时,必须​使用不同的工作架构。
选项 用于连接的其他选项。 下表列出了可用的选项。

对于Vertica Analytics,您可以设置以下其他选项:

table 0-row-2 1-row-2
选项 描述
TimeZoneName 要使用的时区的名称。 此值表示TIMEZONE会话参数。 有关时区的更多信息,请阅读Vertica Analytics关于时区的文档

添加连接的详细信息后,请注意以下其他设置:

NOTE
要对给定数据库使用联合受众合成,必须允许列表与该数据库关联的​所有 IP地址。
设置
详细信息
启用连接
布尔值切换,确定是否自动启用连接。
服务器IP
一个弹出窗口,显示连接数据库需要列入允许列表的IP地址。
测试连接
允许您验证配置详细信息。

现在,您可以依次选择​ 部署函数 ​和​ 添加 ​以完成联合数据库与Experience Platform之间的连接。

recommendation-more-help
fadff0d9-29d0-4d44-99a6-2499b0b7778b