保存和共享 Tableau Prep 工作

相关文章推荐

有胆有识的泡面 · JS 数组转字符串中间用指定符号隔开_js ...· 2 年前 ·

神勇威武的斑马 · screen显示窗口查看历史输出_scree ...· 2 年前 ·

热心的酱肘子 · Mysql 连接到VLAN外的外部/远程服务器· 2 年前 ·

骑白马的开水瓶 · 常见问题_开发指南_对象存储_企业版· 2 年前 ·

</noscript><div id="app" class="wrapper"><header id="tableau-help-article-header" class="container--full-width quick-help-header"><div class="container--centered"><div class="header__mobile-menu quick-help-hidden"><menu-tree-toggle/></div><div class="header__logo quick-help-hidden"><a id="tableau-logo" href="https://www.tableau.com/zh-cn/"><img src="./Resources/tableau-logo.png" class="header__logo__img" alt="Tableau"/></a></div><div class="header__search"><search-header-help placeholder="搜索"/></div></div></header><div class="container--navigation-top quick-help-hidden content-only-hidden"><div id="help-subheader" class="subheader print-hidden"><div class="container--centered"><h1 class="heading--subheader">Tableau Prep 帮助</h1></div></div><div class="container--top-links"><div class="container--centered container--breadcrumbs"><div><breadcrumb-links-help/></div></div><div id="help-container-menu-headings" class="container--menu-headings"><nav class="nav-medium-screen"><menu-heading-links-static-help menu-title="本文内容" :disabled="false" :headings="pageHeadings"/></nav></div></div></div><div class="section--main container--full-width"><div class="container--centered"><nav class="nav-side nav-side--left" role="navigation"><menu-tree-help menu-title="内容"/></nav><article role="main"><h2 class="topic--title" id="topic-title" tabindex="-1">保存和共享工作</h2><div class="caption article__tags content-only-hidden quick-help-hidden"> </div><div id="content-body">&#13; <div id="mc-main-content">注意：从版本 2020.4 开始，您还可以在 Tableau Server 和 Tableau Cloud 中创建和编辑流程。除非特别指出，本主题中的内容适用于所有平台。在流程的任何位置，您都可以手动保存工作，或者让 Tableau 在 Web 上创建或编辑流程时自动为您保存工作。在 Web 上处理流程时，存在一些差异。有关在 Web 上制作流程的详细信息，请参见 <a href="https://help.tableau.com/current/server/zh-cn/prep_web_auth.htm" target="_blank">Tableau Server(链接在新窗口中打开)</a> 和 <a href="https://help.tableau.com/current/online/zh-cn/prep_web_auth.htm" target="_blank">Tableau Cloud(链接在新窗口中打开)</a> 帮助中的 Web 上的 Tableau Prep。<table style="width: 100%;" class="simple-table"><colgroup><col/><col/></colgroup><tbody><tr><th>Tableau Prep Builder</th><th>Web 上的 Tableau Prep</th></tr><tr><td><ul><li>在 Tableau Desktop 中查看流程中数据的预览。</li><li>在流程输入中包括直接文件连接或打包文件，然后将打包的流程发布到服务器。</li><li>将流程输出到文件、已发布的数据源或数据库（版本 2020.3.1 及更高版本）。</li></ul></td><td><ul><li>在 Web 上创建和编辑流程。</li><li>上载流程输入的文件并连接到各种数据源。</li><li>将流程输出到已发布的数据源或数据库。</li></ul></td></tr></tbody></table>若要使数据保持最新，您可以从 Tableau Prep Builder 中或通过命令行手动运行流程。您还可以运行在 Tableau Server 或 Tableau Cloud 上手动发布或按计划发布的流程。有关运行流程的详细信息，请参见<a href="prep_conductor_publish_flow.htm#run_flows" class="MCXref xref" xrefformat="{paratext}">将流程发布到 Tableau Server 或 Tableau Cloud</a>。<h2 is="heading-item" :level="2" classstring="Heading2" id="保存您的流程"><a name="Save"/>保存您的流程</h2>在 Tableau Prep Builder 中，您可以手动保存流程以在执行任何其他操作之前备份您的工作。流程以 Tableau Prep 流程 (.tfl) 文件格式保存。您也可以随流程一起打包本地文件（Excel、文本文件和 Tableau 数据提取）以与其他人共享，就像在 Tableau Desktop 中打包工作簿用于共享一样。只能随流程一起打包本地文件。举例来说，不会包括来自数据库连接的数据。在 Web 制作中，本地文件会自动随流程打包在一起。尚不支持直接文件连接。在保存打包流程时，流程将保存为打包 Tableau 流程文件 (.tflx)。<ul><li>若要手动保存流程，请从顶部菜单中选择“文件”&gt;“保存”。</li><li>在 Tableau Prep Builder 中，若要随流程一起打包数据文件，请从顶部菜单中执行以下操作之一：<ul><li>选择“文件”&gt;“导出打包流程”</li><li>选择“文件”&gt;“另存为”。然后，在“另存为”对话框中，从“另存为类型”下拉菜单中选择“打包 Tableau 流程文件”。</li></ul></li></ul><h3 is="heading-item" :level="3" id="在-web-上自动保存流程"><a name="autosave"/>在 Web 上自动保存流程</h3>在 Tableau Server 版本 2020.4 及更高版本上支持。如果在 Web 上创建或编辑流程，则在对流程进行更改（连接到数据源、添加步骤等）时，您的工作就会每隔几秒钟自动保存一次草稿，这样您就不会丢失工作。您只能将流程保存到当前已登录的服务器。您不能在一台服务器上创建草稿流程，并尝试将其保存或发布到另一台服务器。如果要将流程发布到服务器上的其他项目，请使用“文件”&gt;“发布为”菜单选项，然后从对话框中选择项目。草稿流程只能由您查看，直到您发布它们，并使其可供有权访问您服务器上的项目的任何人使用。处于草稿状态的流程会使用“草稿”徽章进行标记，以便您可以轻松地找到正在进行中的流程。如果流程从未发布，则“草稿”徽章旁边将显示“从未发布”徽章。<img src="Img/prep_save_drafts.png" alt=""/>发布流程以及编辑并重新发布流程后，将创建一个新版本。您可以在“修订历史记录”对话框中查看流程版本列表。从“浏览”页面中，单击 <img src="Img/prep_moreoptions_icon.png" alt=""/>“操作”菜单并选择“修订历史记录”。有关修订历史记录的详细信息，请参见 Tableau Desktop 帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/qs_revision_history.htm" target="_blank">处理内容修订(链接在新窗口中打开)</a>。注意：“自动保存”功能默认情况下已启用。管理员可以（但不建议）在站点上禁用自动保存。若要关闭自动保存，请使用 Tableau Server REST API 方法“更新站点”，并将 <code>flowAutoSaveEnabled</code> 属性设置为 false。有关详细信息，请参见 <a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_sites.htm#update_site" target="_blank">Tableau Server REST API 站点方法：更新站点(链接在新窗口中打开)</a>。<h3 is="heading-item" :level="3" id="自动文件恢复"><a name="file_recovery"/>自动文件恢复</h3>在 Tableau Prep Builder 版本 2021.3.3 及更高版本中受支持。默认情况下，如果应用程序冻结或崩溃，Tableau Prep Builder 将自动保存任何已打开流程的草稿。草稿流程保存在“我的 Tableau Prep 存储库”中的“已恢复流程”文件夹中。下次打开应用程序时，将显示一个对话框，其中包含可供选择的已恢复流程的列表。您可以打开恢复的流程并在停止的位置继续，或者在不需要时删除恢复的流程文件。注意：如果在“已恢复流程”文件夹中有已恢复流程，则每次打开应用程序时都会显示此对话框，直到该文件夹为空。<img src="Img/prep_filerecovery.png" alt=""/>如果不希望启用此功能，作为管理员，您可以在安装期间或安装之后将其关闭。有关如何关闭此功能的详细信息，请参见 Tableau Desktop 和 Tableau Prep 部署指南中的<a href="https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_setting_changes.htm#turn-off-autosave-tableau-desktop-only" target="_blank">关闭恢复(链接在新窗口中打开)</a>。<h2 is="heading-item" :level="2" classstring="Heading2" id="在-tableau-desktop-中查看流程输出"><a name="View"/>在 Tableau Desktop 中查看流程输出</h2>注意：此选项在 Web 上不可用。当您清理数据时，有时您可能希望通过在 Tableau Desktop 中查看数据来检查进度。当流程在 Tableau Desktop 中打开时，Tableau Prep Builder 会创建一个永久的 Tableau .hyper 文件和一个 Tableau 数据源 (.tds) 文件。这些文件保存在 Tableau 存储库的“数据源”文件中，以便您能够随时试验数据。在 Tableau Desktop 中打开流程时，您可以看到流程中您正在处理的数据样本，其已应用到所选步骤为止的操作。注意：尽管您可以体验数据，但 Tableau 只会向您显示数据示例，您将无法将工作簿另存为打包工作簿 (.twbx)。当您准备在 Tableau 处理自己的数据时，请在流程中创建一个输出步骤，并将输出保存到文件或另存为发布的数据源，然后在 Tableau 中连接到完整数据源。若要在 Tableau Desktop 中查看数据样本，请执行以下操作：<ol style="list-style-type: decimal;margin-left: 20pt;" start="1"><li value="1">右键单击要在其中查看数据的步骤，并从上下文菜单中选择“在 Tableau Desktop 中预览”。<img src="Img/prep_preview_in_desktop.png" alt=""/></li><li value="2">Tableau Desktop 将打开“工作表”选项卡。</li></ol><h2 is="heading-item" :level="2" classstring="Heading2" id="创建数据提取文件和已发布数据源"><a name="Extract"/>创建数据提取文件和已发布数据源</h2>重要信息：从 Tableau Prep Builder 版本 2020.3.1 开始，不再支持使用 Tableau 数据提取 (.tde) 文件作为流程输出类型。为避免流程运行失败，请将流程输出从 (.tde) 文件转换为 Hyper 数据提取 (.hyper) 文件。发布到 Tableau Server 或 Tableau Cloud 的流程必须下载到 Tableau Prep Builder 才能更改文件输出类型。若要创建流程输出，请运行流程。运行流程时，您所做的更改将应用于整个数据集。运行流程会生成 Tableau 数据源 (.tds) 和 Tableau 数据提取 (.hyper) 文件。注意：您可以将数据提取或已发布数据源发布到 Tableau Server 版本 10.0 及更高版本，以及发布到 Tableau Cloud。 <h4>Tableau Prep Builder</h4>您可以依据流程输出创建数据提取文件，以便在 Tableau Desktop 中使用，或与第三方共享数据。采用以下格式创建数据提取文件：<ul><li>Hyper 数据提取 (.hyper)：这是最新的 Tableau 数据提取文件类型，并且只能由 Tableau Desktop 或 Tableau Server 版本 10.5 及更高版本使用。</li><li>逗号分隔值 (.csv)：将数据提取保存到 .csv 文件以与第三方共享数据。导出的 CSV 文件的编码将为带 BOM 的 UTF-8。</li><li>Microsoft Excel (.xlsx)：从版本 2021.1.2 开始，您可以将流程数据输出到 Microsoft Excel 电子表格。不支持旧版 Microsoft Excel .xls 文件类型。</li></ul><h4>Tableau Prep Builder 以及在 Web 上</h4>将您的流程输出发布为已发布数据源或输出到数据库。<ul><li>将您的流程输出作为数据源保存到 Tableau Server 或 Tableau Cloud，以共享您的数据并提供对您已清理、整形和组合的数据的集中访问。</li><li>将您的流程输出保存到数据库，以使用干净、准备好的流程数据创建、替换或附加表数据。有关详细信息，请参见<a href="#write_to_DB" class="MCXref xref" xrefformat="{paratext}">将流程输出数据保存到外部数据库</a>。</li></ul>在运行流程时使用增量刷新，通过仅刷新新数据而不是完整数据集来节省时间和资源。有关如何使用增量刷新配置和运行流程的信息，请参见<a href="prep_incremental_refresh.htm" class="MCXref xref" xrefformat="{paratext}">使用增量刷新来刷新流程数据</a>。注意：若要将 Tableau Prep Builder 输出发布到 Tableau Server，必须启用 Tableau Server REST API。有关详细信息，请参见 Tableau REST API 帮助中的 <a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_requ.htm" target="_blank">REST API 要求(链接在新窗口中打开)</a>。若要发布到使用安全套接字层 (SSL) 加密证书的服务器，还要在运行 Tableau Prep Builder 的计算机上执行一些额外配置步骤。有关详细信息，请参见 Tableau Desktop 和 Tableau Prep Builder 部署指南中的<a href="https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_intro.htm" target="_blank">安装之前(链接在新窗口中打开)</a>。<h4>在流程输出中包含参数</h4>从版本 2021.4 开始在 Tableau Prep Builder 和 Web 上受支持在流程输出文件名、路径、表名或自定义 SQL 脚本（版本 2022.1.1 及更高版本）中包含参数值，以轻松针对不同数据集运行流程。有关详细信息，请参见<a href="prep_parameters.htm" class="MCXref xref" xrefformat="{paratext}">在流程中创建和使用参数</a>。<h3 is="heading-item" :level="3" id="创建数据提取到文件"><a name="file_extract"/>创建数据提取到文件</h3>注意：在 Web 上创建或编辑流程时，此输出选项不可用。<ol><li value="1">单击步骤上的加号图标 <img src="Img/prep_addicon.png" alt=""/>，并选择“添加输出”。如果以前运行过流程，请单击输出步骤上的运行流程 <img src="Img/prep_run_flow.png" alt=""/> 按钮。这将运行流程并更新输出。“输出”窗格将打开，并显示数据的快照。<img src="Img/prep_outputpane.png" alt=""/></li><li value="2">在左侧窗格中，从“将输出保存到”下拉列表中选择“文件”。在以前的版本中，选择“保存到文件”。</li><li value="3">单击“浏览”按钮，然后在“将数据提取另存为”对话框中输入文件的名称，并单击“接受”。</li><li value="4">在“输出类型”字段中，从以下输出类型中进行选择：<ul><li>Tableau 数据提取 (.hyper)</li><li>逗号分隔值 (.csv)</li></ul></li><li value="5">（Tableau Prep Builder 版本 2020.2.1 及更高版本）在“写入选项”部分，查看用于将新数据写入文件并根据需要进行任何更改的默认写入选项。有关详细信息，请参见<a href="prep_incremental_refresh.htm#flow-writeoptions" class="MCXref xref" xrefformat="{paratext}">配置写入选项</a>。<ul><li>创建表：此选项创建新表，或将现有表替换为新输出。</li><li>追加到表：此选项将新数据添加到现有表中。如果表不存在，将创建一个新表，后续运行会将新行添加到此表。注意：对于 .csv 输出类型，不支持“追加到表”。有关支持的刷新组合的详细信息，请参见<a href="prep_incremental_refresh.htm#refresh-options" class="MCXref xref" xrefformat="{paratext}">流程刷新选项</a>。</li></ul></li><li value="6">单击“运行流程”以运行流程并生成数据提取文件。</li></ol><h3 is="heading-item" :level="3" id="创建数据提取到-microsoft-excel-工作表"><a name="publish_excel"/>创建数据提取到 Microsoft Excel 工作表</h3>在 Tableau Prep Builder 版本 2021.1.2 及更高版本中受支持。在 Web 上创建或编辑流程时，此输出选项不可用。当您流程数据输出到 Microsoft Excel 工作表时，您可以在现在工作表中附加或替换数据。以下条件适用：<ul><li>仅支持 Microsoft Excel .xlsx 文件格式。</li><li>工作表行从单元格 A1 开始。</li><li>在附加或替换数据时，会假定第一行为标题。</li><li>创建新工作表时会添加标题名称，但在将数据添加到现有工作表时不会添加。</li><li>现有工作表中的任何格式设置或公式不适用于流程输出。</li><li>目前不支持写入到指定的表或范围。</li><li>当前不支持增量刷新。</li></ul>将流程数据输出到 Microsoft Excel 工作表文件<ol><li value="1">单击步骤上的加号图标 <img src="Img/prep_addicon.png" alt=""/>，并选择“添加输出”。如果以前运行过流程，请单击输出步骤上的运行流程 <img src="Img/prep_run_flow.png" alt=""/> 按钮。这将运行流程并更新输出。“输出”窗格将打开，并显示数据的快照。<img src="Img/prep_write_to_excel3.png" alt=""/></li><li value="2">在左侧窗格中，从“将输出保存到”下拉列表中选择“文件”。</li><li value="3">单击“浏览”按钮，然后在“将数据提取另存为”对话框中输入或选择文件名，并单击“接受”。</li><li value="4">在“输出类型”字段中，选择“ Microsoft Excel (.xlsx)”。<img src="Img/prep_write_to_excel4.png" alt=""/></li><li value="5">在“工作表”字段中，选择要将结果写入的工作表，或改为在字段中输入新名称，然后单击“创建新表”。</li><li value="6">在“写入选项”部分中，选择以下写入选项之一：<ul><li>创建表：使用流程数据创建或重新创建（如果文件已经存在）工作表。</li><li>追加到表：在现有工作表中添加新行。如果工作表不存在，则创建一个，并且后续流程运行会向该工作表添加行。</li><li>替换数据：用流程数据替换现有工作表中的第一行以外的所有现有数据。字段比较显示流程中与工作表中字段匹配的字段（如果工作表已存在）。如果工作表是新的，则显示一对一字段匹配。任何不匹配的字段都被忽略。<img src="Img/prep_write_to_Excel2.png" alt=""/></li></ul></li><li value="7">单击“运行流程”以运行流程并生成 Microsoft Excel 数据提取文件。</li></ol><h3 is="heading-item" :level="3" id="创建发布的数据源"><a name="publish_data_source"/>创建发布的数据源</h3><ol><li value="1">单击步骤上的加号图标 <img src="Img/prep_addicon.png" alt=""/>，并选择“添加输出”。注意：Tableau Prep Builder 将刷新以前发布的数据源，并保留数据源中可能包含的任何数据建模（例如计算字段、数字格式设置等）。如果无法刷新数据源，则将替换数据源，包括数据建模。</li><li value="2">“输出”窗格将打开，并显示数据的快照。<img src="Img/prep_publishasdatasource2.png" alt=""/></li><li value="3">从“将输出保存到”下拉列表中，选择“已发布数据源”（在以前的版本中选择 “发布为数据源”）。填写以下字段：<ul><li>服务器（仅限 Tableau Prep Builder）：选择要在其中发布数据源和数据提取的服务器。如果未登录到服务器，则会提示您登录。注意：从 Tableau Prep Builder 版本 2020.1.4 开始，在您登录到服务器后，Tableau Prep Builder 会在关闭应用程序时记住服务器名称和凭据。下次打开应用程序时，您已经登录服务器。在 Mac 上，可能会提示您提供对 Mac 密钥链的访问权限，以便 Tableau Prep Builder 能够安全地使用 SSL 证书来连接到 Tableau Server 或 Tableau Cloud 环境。如果要输出到 Tableau Cloud，请在“serverUrl”中包括您的站点托管于其上的 pod。例如，“https://eu-west-1a.online.tableau.com”，而不是“https://online.tableau.com”。</li><li>项目：选择要在其中加载数据源和数据提取的项目。</li><li>名称：输入文件名。</li><li>说明：输入数据源的说明。</li></ul></li><li value="4">（Tableau Prep Builder 版本 2020.2.1 及更高版本）在“写入选项”部分，查看用于将新数据写入文件并根据需要进行任何更改的默认写入选项。有关详细信息，请参见<a href="prep_incremental_refresh.htm#flow-writeoptions" class="MCXref xref" xrefformat="{paratext}">配置写入选项</a><ul><li>创建表：此选项创建新表，或将现有表替换为新输出。</li><li>追加到表：此选项将新数据添加到现有表中。如果表不存在，将创建一个新表，后续运行会将新行添加到此表。</li></ul></li><li value="5">单击“运行流程”以运行流程并发布数据源。</li></ol><h2 is="heading-item" :level="2" id="将流程输出数据保存到外部数据库"><a name="write_to_DB"/>将流程输出数据保存到外部数据库</h2>在 Tableau Prep Builder 版本 2020.3.1 及更高版本中受支持，以及从版本 2020.4 开始，在 Tableau Server 和 Tableau Cloud 上受支持重要信息：此功能使您能够永久删除和替换外部数据库中的数据。请确保您具有写入数据库的权限。 为了防止数据丢失，您可以使用“自定义 SQL”选项复制表数据，并在将流程数据写入表之前运行它。可以通过 Tableau Prep Builder 或 Web 支持的任何连接器连接到数据，并将数据输出到外部数据库。这使您能够在每次运行流程时使用干净、准备好的数据在数据库中添加或更新数据。此功能可用于增量刷新和完全刷新选项。有关如何配置增量刷新的详细信息，请参见<a href="prep_incremental_refresh.htm" class="MCXref xref" xrefformat="{paratext}">使用增量刷新来刷新流程数据</a>。将流程输出保存到外部数据库时，Tableau Prep 将执行以下操作：<ol><li value="1">生成行并针对数据库运行任何 SQL 命令。</li><li value="2">将数据写入输出数据库中的临时表（如果输出到 Snowflake，则为暂存区域）。</li><li value="3">如果操作成功，数据将从临时表（或 Snowflake 的暂存区域）移动到目标表中。</li><li value="4">运行将数据写入数据库后要运行的任何 SQL 命令。</li></ol>如果 SQL 脚本失败，流程将失败。但是，您的数据仍将加载到数据库表中。您可以尝试再次运行流程，也可以在数据库上手动运行 SQL 脚本以应用它。<h3 is="heading-item" :level="3" id="输出选项">输出选项</h3>将数据写入数据库时，可以选择以下选项。如果表不存在，则在首次运行流程时创建该表。<ul><li>追加到表：此选项将数据添加到现有表中。如果表不存在，则在首次运行流程时创建该表，并在每次后续流程运行时将数据添加到该表中。</li><li>创建表：此选项使用流程中的数据创建一个新表。如果该表已存在，则删除表和为表定义的任何现有数据结构或属性，并替换为使用流程数据结构的新表。流程中存在的任何字段都将添加到新的数据库表中。</li><li>替换数据：此选项删除现有表中的数据并将其替换为流程中的数据，但保留数据库表的结构和属性。如果表不存在，则在首次运行流程时创建该表，并且在每次后续流程运行时，表数据将替换。</li></ul><h3 is="heading-item" :level="3" id="其他选项">其他选项</h3>除了写入选项之外，还可以包括自定义 SQL 脚本或向数据库添加新表。<ul><li>自定义 SQL 脚本：输入您的自定义 SQL 并选择是在将数据写入数据库表之前、之后还是之前和之后运行您的脚本。您可以使用这些脚本在将流程数据写入表之前创建数据库表的副本、添加索引、添加其他表属性等等。注意：从版本 2022.1.1 开始，您还可以在 SQL 脚本中插入参数。有关详细信息，请参见<a href="prep_parameters.htm#output_parameters" class="MCXref xref" xrefformat="{paratext}">将用户参数应用于输出步骤</a>。</li><li>添加新表：向数据库添加具有唯一名称的新表，而不是从现有表列表中选择一个表。如果要应用默认架构（Microsoft SQL Server 和 PostgreSQL）以外的架构，可以使用语法 <code>[schema name].[table name]</code> 指定该架构。</li></ul><h3>支持的数据库和数据库要求</h3>Tableau Prep 支持将流程数据写入特定数量的数据库中的表。在 Tableau Cloud 中按计划运行的流程只有在云托管时才能写入这些数据库。不支持专用网络连接和通过 Tableau Bridge 的本地连接。您可以在 Tableau Cloud 中创建使用 Bridge 刷新数据的已发布数据源，然后 Prep 可以连接到已发布的数据源。某些数据库具有数据限制或要求。Tableau Prep 可能还会施加一些限制，以便在将数据写入支持的数据库时保持最佳性能。下表列出了可在其中保存流程数据的数据库，以及任何数据库限制或要求。不符合这些要求的数据在运行流程时可能会导致错误。注意：尚不支持为字段设置字符限制。但是，您可以在数据库中创建包含字符限制约束的表，然后使用“替换数据”选项替换数据，但保留数据库中的表结构。<table style="width: 100%;" class="simple-table"><colgroup><col/><col/></colgroup><tbody><tr><th>数据库</th><th>要求或限制</th></tr><tr><td>Amazon Redshift</td><td><ul><li>不支持排序规则顺序。有关详细信息，请参见 <a href="https://docs.aws.amazon.com/redshift/index.html" target="_blank">Amazon Redshift(链接在新窗口中打开)</a> 文档。</li><li>字段名将转换为全小写。</li><li>可为文本字段值最多写入 8192 个字符。较长的值会被截断。</li></ul></td></tr><tr><td>Google BigQuery</td><td><ul><li>Tableau 最多可以将 2 GB 作为输出写入表。</li></ul></td></tr><tr><td>Microsoft SQL Server</td><td><ul><li>可为文本字段值最多写入 3072 个字符。较长的值会被截断。</li><li>（版本：2022.3.1）发布到 Tableau Server 的流程输出允许使用运行身份凭据对 Microsoft SQL Server 数据库进行写入访问。请参见 <a href="https://help.tableau.com/current/server/zh-cn/cli_configuration-set_tsm.htm">intsm configuration set 选项</a>中的 <code>maestro.output.write_to_mssql_using_runas</code>。</li></ul></td></tr><tr><td>MySQL</td><td><ul><li>可为文本字段值最多写入 8192 个字符。较长的值会被截断。</li></ul></td></tr><tr><td>Oracle</td><td><ul><li>字段名和表名不能超过 30 个字符。</li><li>可为文本字段值最多写入 1000 个字符。较长的值会被截断。</li><li>字段名中的特殊字符可能会导致错误。</li></ul></td></tr><tr><td>Pivotal Greenplum Database</td><td><ul><li>可为文本字段值最多写入 8192 个字符。较长的值会被截断。</li></ul></td></tr><tr><td>PostgreSQL</td><td><ul><li>可为文本字段值最多写入 8192 个字符。较长的值会被截断。</li></ul></td></tr><tr><td>SAP HANA</td><td><ul><li>可为文本字段值最多写入 8192 个字符。较长的值会被截断。</li></ul></td></tr><tr><td>Snowflake</td><td><ul><li>可为文本字段值最多写入 8192 个字符。较长的值会被截断。</li><li>必须将仓库选项设置为自动恢复，以使 Tableau Prep 能够将数据写入数据库仓库。有关详细信息，请参见 Snowflake 文档中的<a href="https://docs.snowflake.com/en/user-guide/warehouses-overview.html#auto-suspension-and-auto-resumption" target="_blank">自动暂停和自动恢复(链接在新窗口中打开)</a>。</li></ul></td></tr><tr><td>Teradata</td><td><ul><li>可为文本字段值最多写入 1000 个字符。较长的值会被截断。</li></ul></td></tr><tr><td>Vertica</td><td><ul><li>可为文本字段值最多写入 8192 个字符。较长的值会被截断。</li></ul></td></tr></tbody></table><h3>将流程数据保存到数据库</h3>注意：不支持使用 Windows 身份验证将流程输出写入数据库。如果使用这种身份验证方法，则需要更改连接身份验证以使用用户名和密码。 您可以在发布流程时为数据库嵌入凭据。有关嵌入凭据的详细信息，请参见<a href="prep_conductor_publish_flow.htm#Publish" class="MCXref xref" xrefformat="{paratext}">从 Tableau Prep Builder 中发布流程</a>中的“数据库”部分<ol><li value="1">单击步骤上的加号图标 <img src="Img/prep_addicon.png" alt=""/>，并选择“添加输出”。</li><li value="2">从“将输出保存到”下拉列表中，选择“数据库表”。</li><li value="3">在“设置”选项卡中，输入以下信息：<ul><li>在“连接”下拉列表中，选择要在其中写入流程输出的数据库连接器。仅显示受支持的连接器。这可以是用于流程输入的连接器的同一连接器或其他连接器。如果选择其他连接器，系统将提示您登录。重要信息：请确保您对选择的数据库具有写入权限。否则，流程可能只会部分处理数据。<img src="Img/prep_wtdb2.png" alt=""/></li><li>在“数据库”下拉列表中，选择要在其中保存流程输出数据的数据库。</li><li>在“表”下拉列表中，选择要在其中保存流程输出数据的表。根据所选的“写入选项”，将创建一个新表，流程数据将替换表中的任何现有数据，或者流程数据将添加到现有表中。若要在数据库中创建新表，请改为在字段中输入唯一的表名，然后单击“创建新表”。首次运行流程时，无论选择哪个写入选项，都将使用与流程相同的架构在数据库中创建表。<img src="Img/prep_wtdb3.png" alt=""/></li></ul></li><li value="4">输出窗格将显示数据的快照。字段比较显示流程中与表中字段匹配的字段（如果表已存在）。如果表是新的，则显示一对一字段匹配。<img src="Img/prep_wtdb1.png" alt=""/>如果存在任何字段不匹配，状态说明会显示任何错误。<ul><li>不匹配：字段将被忽略：字段存在于流程中，但不在数据库中。除非选择“创建表”写入选项并执行完全刷新，否则不会将该字段添加到数据库表中。然后将流程字段添加到数据库表并使用流程输出架构。</li><li>不匹配：字段将包含 Null 值：字段存在于数据库中，但不在流程中。流程将 Null 值传递到字段的数据库表。如果该字段确实存在流程中，但由于字段名不同而不匹配，您可以导航到清理步骤并编辑字段名以匹配数据库字段名。有关如何编辑字段名的详细信息，请参见<a href="prep_clean.htm#clean_list" class="MCXref xref" xrefformat="{paratext}">应用清理操作</a>。</li><li>错误：字段数据类型不匹配：分配给流程中字段和向其中写入输出的数据库表的数据类型必须匹配，否则流程将失败。您可以导航到清理步骤并编辑字段数据类型来修复此问题。有关更改数据类型的信息，请参见<a href="prep_explore.htm#reviewdatatypes" class="MCXref xref" xrefformat="{paratext}">查看分配给数据的数据类型</a>。</li></ul></li><li value="5">选择写入选项：您可以为完全刷新和增量刷新选择其他选项，并在选择流程运行方法时应用该选项。有关使用增量刷新运行流程的详细信息，请参见<a href="prep_incremental_refresh.htm" class="MCXref xref" xrefformat="{paratext}">使用增量刷新来刷新流程数据</a>。<ul><li>追加到表：此选项将数据添加到现有表中。如果表不存在，则在首次运行流程时创建该表，并在每次后续流程运行时将数据添加到该表中。</li><li>创建表：此选项将创建新表。如果具有相同名称的表已存在，则删除现有表并替换为新表。为表定义的任何现有数据结构或属性也将被删除，并替换为流程数据结构。流程中存在的任何字段都将添加到新的数据库表中。</li><li>替换数据：此选项删除现有表中的数据并将其替换为流程中的数据，但保留数据库表的结构和属性。</li></ul></li><li value="6">（可选）单击“自定义 SQL”选项卡并输入 SQL 脚本。您可以输入要在将数据写入表之前和之后运行的脚本。<img src="Img/prep_wtdb4.png" alt=""/></li><li value="7">单击“运行流程”以运行流程并将数据写入所选的数据库。</li></ol><h2 is="heading-item" :level="2" id="将流程输出数据保存到-crm-analytics-中的数据集"><a name="output_crma"/>将流程输出数据保存到 CRM Analytics 中的数据集</h2>从版本 2022.3 开始在 Tableau Prep Builder 和 Web 上受支持。注意：在整合外部来源的数据时，CRM Analytics 有几个要求和一些限制。为了确保您可以成功地将流程输出写入 CRM Analytics，请参见 Salesforce 帮助中的<a href="https://help.salesforce.com/s/articleView?id=sf.bi_integrate_considerations.htm" target="_blank">将数据集成到数据集之前的注意事项(链接在新窗口中打开)</a>。使用 Tableau Prep 清理数据，并在 CRM Analytics 中获得更好的预测结果。只需通过 Tableau Prep Builder 或 Web 上 Tableau Prep 支持的任何连接器连接到数据。然后，应用转换来清理您的数据，并将您的流程数据直接输出到您有权访问的 CRM Analytics 中的数据集。无法使用命令行界面运行向 CRM Analytics 输出数据的流程。您可以使用 Tableau Prep Builder 手动运行流程，也可以使用 Tableau Prep Conductor 在 Web 上按计划运行流程。<h3>先决条件</h3>若要将流程数据输出到 CRM Analytics，请检查您在 Salesforce 和 Tableau 中是否拥有以下许可证、访问权限和许可。<div><h4>Salesforce 要求</h4><table class="table--plain"><colgroup><col style="width: 30%;"/><col style="width: 70%;"/></colgroup><thead><tr><th class="table--plain" style="text-align: left;">要求</th><th class="table--plain" style="text-align: left;">描述</th></tr></thead><tbody><tr><td class="table--plain">Salesforce 权限</td><td class="table--plain">您必须获得 CRM Analytics Plus 或 CRM Analytics Growth 许可证。CRM Analytics Plus 许可证包括权限集：<ul><li>CRM Analytics Plus 管理员：启用管理 CRM Analytics 平台和 Einstein Discovery 所需的所有权限，包括创建和管理 CRM Analytics 模板化应用和 Apps 的权限。</li><li>CRM Analytics Plus 用户：启用使用 CRM Analytics 平台和 Einstein Discovery 以及 CRM Analytics 模板化应用程序以及应用程序所需的所有权限。</li></ul>CRM Analytics Growth 许可证包括权限集：<ul><li>CRM Analytic Growth 管理员：启用管理 CRM Analytics 平台所需的所有权限，包括创建和管理 CRM Analytics 模板化应用和 Apps 的权限。</li><li>CRM Analytics Growth 用户：启用使用 CRM Analytics 平台和 CRM Analytics 模板化应用程序以及应用程序所需的所有权限。</li></ul>有关详细信息，请参见 Salesforce 帮助中的<a href="https://help.salesforce.com/s/articleView?id=sf.bi_help_setup_general.htm" target="_blank">了解 CRM Analytics 许可证和权限集(链接在新窗口中打开)</a>以及<a href="https://help.salesforce.com/s/articleView?id=sf.bi_help_setup_basic.htm" target="_blank">选择和分配用户权限集(链接在新窗口中打开)</a>。</td></tr><tr><td class="table--plain">管理员设置</td><td class="table--plain">Salesforce 管理员将需要配置：<ul><li>Tableau Prep 扩展程序：配置 Salesforce，以便针对 Tableau Server <a href="https://help.tableau.com/current/server/zh-cn/config_oauth_sfdc.htm#step-1-create-a-salesforce-connected-app" target="_blank">创建已连接应用(链接在新窗口中打开)</a>（基本）。仅对于 Tableau Server 是必需的。</li></ul></td></tr></tbody></table><h4>Tableau Prep 要求</h4><table class="table--plain"><colgroup><col style="width: 30%;"/><col style="width: 70%;"/></colgroup><thead><tr><th class="table--plain" style="text-align: left;">要求</th><th class="table--plain" style="text-align: left;">描述</th></tr></thead><tbody><tr><td class="table--plain">Tableau Prep 许可证和权限</td><td class="table--plain">“Creator”许可证作为创建者，您需要登录您的 Salesforce org 帐户并进行身份验证，然后才能选择“应用和数据集”来输出您的流数据。</td></tr><tr><td class="table--plain">OAuth 数据连接</td><td class="table--plain">作为服务器管理员，在连接器上使用 Oauth 客户端 ID 和密码配置 Tableau Server 。这是在 Tableau Server 上运行流程所必需的。有关详细信息，请参见 Tableau Server 帮助中的<a href="https://help.tableau.com/current/server/zh-cn/config_oauth_sfdc.htm#step-2-configure-tableau-server-for-salesforcecom-oauth" target="_blank">针对 Salesforce.com Oauth 配置 Tableau Server(链接在新窗口中打开)</a>。</td></tr></tbody></table><h3 is="heading-item" :level="3" id="将流程数据保存到-crm-analytics">将流程数据保存到 CRM Analytics</h3>从 Tableau Prep Builder 保存到 CRM Analytic s时，以下 CRM Analytics 输入限制适用。<ul><li>外部数据上传的最大文件大小：40 GB</li><li>连续 24 小时内所有外部数据上传的最大文件大小：50 GB</li></ul><ol><li value="1">单击步骤上的加号图标 <img src="Img/prep_addicon.png" alt=""/>，并选择“添加输出”。</li><li value="2">从“将输出保存到”下拉列表中，选择“CRM Analytics”。<img src="Img/prep_output_crma_signin.png" alt=""/></li><li value="3">在“数据集”部分，连接到 Salesforce。登录 Salesforce 并单击“Allow”（允许）以授予 Tableau 访问 CRM Analytics 应用程序和数据集的权限，或选择现有的 Salesforce 连接</li><li value="4">在“Name”（名称）字段中，选择现有数据集名称。这将用您的流程输出覆盖和替换数据集。否则，键入新名称并单击“Create new dataset”（创建新数据集），以在所选 CRM Analytics 应用软件创建新数据集。注意：数据集名称不能超过 80 个字符。<img src="Img/prep_output_crma_dataset.png" alt=""/></li><li value="5">在“Name”（名称）字段下，验证显示的应用程序是您有权写入的应用程序。若要更改应用程序，请单击“Browse Datasets”（浏览数据集），然后从列表中选择应用程序，在“Name”（名称）字段中输入数据集名称，然后单击“Accept”（接受）。<img src="Img/prep_output_crma_dataset_app.png" alt=""/></li><li value="6">在“Write Options”（写入选项）部分，“Full refresh”（完全刷新）和“Create table”（创建表）是唯一受支持的选项。</li><li value="7">单击“Run Flow”（运行流程）以运行流程并将数据写入 CRM Analytics 数据集。如果您的流程运行成功，您可以在数据管理器的“Monitor”（监控）选项卡中验证 CRM Analytics 中的输出结果。有关此功能的详细信息，请参见 Salesforce 帮助中的<a href="https://help.salesforce.com/s/articleView?id=sf.bi_integrate_systemjob_monitoring.htm" target="_blank">监控外部数据上载(链接在新窗口中打开)</a>。</li></ol></div><h2 is="heading-item" :level="2" id="将流程输出数据保存到-data-cloud"><a name="output_data_cloud"/>将流程输出数据保存到 Data Cloud</h2>从版本 2023.3 开始在 Tableau Prep Builder 和 Web 上受支持。使用 Tableau Prep 准备数据，然后将数据与 Data Cloud 中的现有数据集关联。使用 Tableau Prep Builder 或 Web 上的 Tableau Prep 支持的任何连接器导入数据、清理和准备数据，然后使用摄取 API 将流程数据直接输出到 Data Cloud。<h3 is="heading-item" :level="3" id="权限先决条件">权限先决条件</h3><table class="table--plain"><colgroup><col style="width: 30%;"/><col style="width: 70%;"/></colgroup><tbody><tr><td class="table--plain">Salesforce 许可证</td><td class="table--plain">有关 Data Cloud 版本和附加许可证的信息，请参见 Salesforce 帮助中的 <a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_dc_editions.htm">Data Cloud 标准版本和许可证</a>。另请参见 <a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_limits_and_guidelines.htm">Data Cloud 限制和指南</a>。</td></tr><tr><td class="table--plain">数据空间权限</td><td class="table--plain">您必须被分配到数据空间并被分配到 Data Cloud 中的以下权限集之一：<ul><li>Customer Data Cloud 管理员</li><li>适用于营销管理员的 Data Cloud</li><li>适用于营销数据感知专家的 Data Cloud</li></ul>有关详细信息，请参见<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_data_spaces.htm">数据空间</a>和<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_data_space_permission_sets.htm">数据空间权限集</a>。</td></tr><tr><td class="table--plain">摄取到 Data Cloud 权限</td><td class="table--plain">您必须被分配以下权限才能进行现场访问以摄取到 Data Cloud：<ul><li>Data Cloud Salesforce 连接器</li></ul>有关详细信息，请参见<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_enable_user_permissions_external_salesforce_org.htm">启用对象和字段权限</a>。</td></tr><tr><td class="table--plain">Salesforce 配置文件</td><td class="table--plain">启用配置文件访问权限：<ul><li>管理权限：启用 API</li><li>已连接应用访问权限： NameOfConnectedApp</li></ul></td></tr><tr><td class="table--plain">Tableau Prep 许可证和权限</td><td class="table--plain">“Creator”许可证作为创建者，您必须登录您的 Salesforce org 帐户并进行身份验证，然后才能选择“应用和数据集”来输出您的流数据。</td></tr></tbody></table><h3 is="heading-item" :level="3" id="将流程数据保存到-data-cloud">将流程数据保存到 Data Cloud</h3>如果您已在使用摄取n API 并手动调用 API 将数据集保存到 Data Cloud，则可以使用 Tableau Prep 简化该工作流程。Tableau Prep 的先决条件配置相同。如果这是您第一次将数据保存到 Data Cloud，请遵循<a href="#saveDC_setup" class="MCXref xref" xrefformat="{paratext}">Data Cloud 设置先决条件</a>中的设置要求。<ol><li value="1">单击步骤上的加号图标 <img src="Img/prep_addicon.png" alt=""/>，并选择“添加输出”。</li><li value="2">从“将输出保存到”下拉列表中，选择“Salesforce Data Cloud”。</li><img src="Img/prep_saveDC.png" alt=""/><li value="3">从“对象”部分，选择要登录的 Salesforce Data Cloud 组织。<img src="Img/prep_saveDCName.png" alt=""/></li><li value="4">从“Salesforce Data Cloud”菜单中，单击“登录”。</li>浏览器窗口将打开并显示 https://login.salesforce.com/ 。<img src="Img/prep_saveDC_login.png" alt=""/><li value="5">使用您的用户名和密码登录 Data Cloud 组织。</li><li value="6">在“Allow Access”（允许访问）表单中，单击“Allow”（允许）。</li><img src="Img/prep_saveDC_allow.png" alt=""/><li value="7">在“Save output to”（将输出保存到）部分输入摄取 API 连接器和对象名称。</li><img src="Img/prep_saveDC_ingestion.png" alt=""/>Data Lake 对象名称是连接器和对象名称的组合：IngestionAPIConnectorName-ObjectName 。在下面的示例中，连接器名称为 TableauSchema (1)。对象名称为 typeMachineSensorDataString (2)。<img src="Img/prep_saveDC_IngestObj.png" alt=""/><li value="8">“Write Options”（写入选项）部分指示如果表中已存在指定值，则将更新现有行；如果指定值尚不存在，则将插入新行。</li><li value="9">单击“Run Flow”（运行流程）以运行流程并将数据写入 Data Cloud。</li><li value="10">通过查看数据流中的运行状态和数据资源管理器中的对象来验证 Data Cloud中的数据。</li></ol><h4>注意事项</h4><ul><li>您可以一次运行一个流程。必须先在 Data Cloud 中完成运行，然后才能运行另一个保存输出。</li><li>将流程保存到 Data Cloud 的等待时间可能需要一些时间才能完成。在 Data Cloud 中检查状态。</li><li>使用 Upsert 功能将数据保存到 Data Cloud。如果文件中的记录与现有记录匹配，则现有记录将使用数据中的值进行更新。如果未找到匹配项，则将记录创建为新实体。</li><li>对于 Prep Conductor，如果您计划自动运行相同的流程，则数据将不会更新。这是因为仅支持 Upsert。</li><li>在保存到 Data Cloud 过程中您无法中止作业。</li><li>不会对保存到 Data Cloud 的字段进行验证。验证 Data Cloud 中的数据。</li></ul><h3 is="heading-item" :level="3" id="data-cloud-设置先决条件"><a name="saveDC_setup"/>Data Cloud 设置先决条件</h3>这些步骤是将 Tableau Prep 流程保存到 Data Cloud 的先决条件。有关 Data Cloud 概念以及在 Tableau 数据源和 Data Cloud 之间映射数据的详细信息，请参见<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_data_cloud.htm">关于 Salesforce Data Cloud</a>。<h4>设置摄取 API 连接器</h4>通过上载具有 .yaml 文件扩展名的 OpenAPI (OAS) 格式的架构文件，依据源对象创建摄取 API 数据流。架构文件描述了您网站上的数据的结构。有关详细信息，请参见<a href="#YMAL" class="MCXref xref" xrefformat="{paratext}">YMAL文件示例</a>和<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_ingestion_api.htm">摄取 API</a>。<ol><li value="1">单击“设置”齿轮图标，然后单击“Data Cloud 设置” 。</li><li value="2">单击“摄取 API”。</li><li value="3">单击“新建”并提供连接器名称。</li><li value="4">在新连接器的详细信息页面上，上载 OpenAPI (OAS) 格式的架构文件，文件扩展名为 <code>.yaml</code>。架构文件描述了通过 API 传输的数据的结构。</li>注意：摄取 API 架构有设定的要求。在摄取之前，请参见<a href="#saveDC_schemReq" class="MCXref xref" xrefformat="{paratext}">架构要求</a>。<li value="5">单击“预览架构”表单上的“保存” 。</li></ol><h4>创建数据流</h4>数据流是引入 Data Cloud 的数据源。它由摄取到 Data Cloud 中的连接和关联数据组成。<ol><li value="1">转到应用程序启动器并选择“Data Cloud”。</li><li value="2">单击“Data Streams”（数据流）选项卡。</li><li value="3">单击“New”（新建）并选择“Ingestion API”（摄取 API），然后单击“Next”（下一步）。</li><li value="4">选择摄取 API 和对象。</li><li value="5">选择“Data Space”（数据空间）、“Category”（类别）和“Primary Key”（主键），然后单击“Next”（下一步）。</li>必须为 Data Cloud 使用真正的主键。如果不存在，您需要为主键创建一个公式字段。对于“Category”（类别），请在“Profile”（简档）、“Engagement”（参与）或“Other”（其他）之间进行选择。对于用于参与类别的对象，必须存在日期时间字段。简档或其他类型的对象不强加同样的要求。有关详细信息，请参见<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_category.htm">类别</a>和<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_primary_key.htm">主键</a>。<li value="6">单击“Deploy”（部署）。</li>您现在拥有一个数据流和一个数据湖对象。您的数据流现在可以添加到数据空间。<img src="Img/prep_saveDC_data_stream.png" alt=""/></ol><h4>将数据流添加到数据空间</h4>当您将数据从任何来源引入 Data Cloud 时，您可以将数据湖对象 (DLO) 关联到相关数据空间（无论是否有筛选器）。<ol><li value="1">单击“Data Spaces”（数据空间）选项卡。</li><img src="Img/prep_saveDCSF_recent.png" alt=""/><li value="2">选择默认数据空间或您分配到的数据空间的名称。</li><li value="3">单击“Add Data”（添加数据）。</li><li value="4">选择您创建的数据湖对象，然后单击“Next”（下一步）。</li><li value="5">（可选）为对象选择筛选器。</li><li value="6">单击“Save”（保存）。</li></ol><h4>将数据湖对象映射到 Salesforce 对象</h4>数据映射将数据湖对象字段与数据模型对象 (DMO) 字段相关联。<ol><li value="1">转到“Data Stream”（数据流）选项卡并选择您创建的数据流。<img src="Img/prep_saveDC_map.png" alt=""/></li><li value="2">从“Data Mapping”（数据映射）部分，单击“Start”（开始） 。</li>字段映射画布在左侧显示源 DLO，在右侧显示目标 DMO。有关详细信息，请参见<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_map_custom_data_model_objects.htm">映射数据模型对象</a>。</ol><h4>为 Data Cloud 摄取 API 创建已连接应用</h4>在使用摄取n API 将数据发送到 Data Cloud 之前，您必须配置已连接应用。有关更多详细信息，请参见<a href="https://help.salesforce.com/s/articleView?id=sf.connected_app_create_api_integration.htm">为 API 集成启用 OAuth 设置</a>和<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_create_ingestion_api_connected_app.htm">为 Data Cloud 摄取 API 创建已连接应用</a>。作为为摄取 API 设置的已连接应用的一部分，您必须选择以下 OAuth 范围：<ul><li>访问和管理您的 Data Cloud 摄取n API 数据 (cdp_ingest_api)</li><li>管理 Data Cloud 简档数据 (cdp_profile_api)</li><li>对 Data Cloud 数据执行 ANSI SQL 查询 (cdp_query_api)</li><li>通过 API (api) 管理用户数据</li><li>随时代表您执行请求（refresh_token、offline_access）</li></ul><h4><a name="saveDC_schemReq"/>架构要求</h4>若要在 Data Cloud 中创建摄取 API 源，您上载的架构文件必须满足特定要求。请参见<a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_ingestion_api_schema_req.htm">摄取 API 架构的要求</a>。<ul><li>上载的架构必须采用有效的 OpenAPI 格式，并带有 .yml 或 .yaml 扩展名。支持 OpenAPI 版本 3.0.x。</li><li>对象不能有嵌套对象。</li><li>每个架构至少必须有一个对象。每个对象至少必须有一个字段。</li><li>对象的字段不能超过 1000 个。</li><li>对象名称的长度不能超过 80 个字符。</li><li>对象名称只能包含 a-z、AZ-、0-9、_、-。没有 unicode 字符。</li><li>字段名称只能包含 a-z、A-Z、0-9、_、-。没有 unicode 字符。</li><li>字段名称不能是以下任何保留字：date_id、location_id、dat_account_currency、dat_exchange_rate、pacing_period、pacing_end_date、row_count、version。字段名称不能包含字符串 __。</li><li>字段名称不能超过 80 个字符。</li><li>字段满足以下类型和格式：<ul><li>对于文本或布尔类型：字符串</li><li>对于数字类型：数字</li><li>对于日期类型：字符串；格式：日期时间</li></ul></li><li>对象名称不能重复；不区分大小写。</li><li>对象不能有重复的字段名称；不区分大小写。</li><li>有效负载中的日期时间数据类型字段必须采用 ISO 8601 UTC Zulu 格式，格式为 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'。</li></ul>更新架构时，请注意：<ul><li>无法更改现有字段数据类型。</li><li>更新对象时，该对象的所有现有字段都必须存在。</li><li>更新后的架构文件仅包含更改的对象，因此您不必每次都提供完整的对象列表。</li><li>对于用于参与类别的对象，必须存在日期时间字段。<code>profile </code> 或 <code>other </code> 类型的对象不会强加同样的要求。</li></ul><h4><a name="YMAL"/>YMAL文件示例</h4><pre xml:space="preserve">openapi: 3.0.3&#13; components:&#13; schemas:&#13; owner:&#13; type: object&#13; required:&#13; - name&#13; - region&#13; - createddate &#13; properties: &#13; type: integer &#13; format: int64 &#13; name: &#13; type: string &#13; maxLength: 50 &#13; region: &#13; type: string &#13; maxLength: 50 &#13; createddate: &#13; type: string &#13; format: date-time &#13; type: object &#13; required: &#13; - car_id &#13; - color &#13; - createddate &#13; properties: &#13; car_id: &#13; type: integer &#13; format: int64 &#13;