文件输出将数据管道数据集写入内容中的 CSV、GeoJSON 或 Apache Parquet 文件中。 可创建新文件或覆盖现有文件。
参数
下表介绍了文件输出中使用的参数：
| 参数 | 描述 |
|---|---|
输入数据集 | 将作为文件写入的数据集。 |
输出方法 | 指定将用于写入输出结果的方法。 选项为创建（默认）和覆盖。 |
文件格式 | 待写入文件的格式。 选项为 CSV、GeoJSON 和 Apache Parquet。 |
几何字段 | 将在生成的 GeoJSON 文件中表示的几何字段。 此参数不适用于 CSV 或 Aparche Parquet 文件格式。 |
地理空间格式 | 写入 Apache Parquet 文件输出的地理空间格式。 当前，仅支持选项 GeoParquet 1.1。 此参数不适用于 CSV 或 GeoJSON 文件格式。 |
主要几何字段 | 写入 Apache Parquet 文件输出的主要几何字段。 GeoParquet 1.1 规范要求必须具有主要几何字段。 此参数不适用于 CSV 或 GeoJSON 文件格式。 |
标题 | 输出文件项目的标题。 |
如果项目已存在，则覆盖 | 指定是否将覆盖具有提供的输出名称的现有项目（已选中）。 默认启用覆盖。 |
文件夹 | 保存文件的输出文件夹。 |
文件项目 | 下一次运行数据管道时将覆盖的现有文件。 仅当输出方法参数设置为覆盖时，此选项可用。 |
用法说明
要运行数据管道，必须至少配置一个输出。
使用输入数据集参数来识别将作为文件写入的数据集。
使用输出方法参数指定如何写入数据管道结果。 选项如下：
- 创建 - 将在内容中创建新文件。 您可以选择使用如果项目已存在，则覆盖参数，在每次运行数据管道时覆盖文件。
- 覆盖 - 将完全覆盖现有文件。
当选择创建输出方法时，以下参数可用：
- 文件格式参数用于确定待写入文件的类型。 选项为 CSV、GeoJSON 和 Apache Parquet。
- 几何字段参数仅适用于 GeoJSON 文件格式，用于确定生成的 GeoJSON 的几何。 GeoJSON 文件仅支持 WGS84 (4326) 坐标系。 如果几何字段使用了除 WGS84 (4326) 外的其他坐标系，在写入数据前将自动投影该字段。
- 主要几何字段参数用于确定写入 Apache Parquet 文件时使用的几何字段。 此参数仅适用于 Apache Parquet 文件格式，且根据 GeoParquet 1.1 规范，此参数为必需项。 当前，地理空间格式参数仅支持 GeoParquet 1.1 选项。
- 标题参数用于指定将创建或覆盖的项目名称。
- 如果项目已存在，则覆盖参数可用于在不更改输出名称的情况下重新运行数据管道。 此操作将完全覆盖具有指定标题且存储在指定文件夹中的文件。 默认启用此参数。
- 文件夹参数用于确定存储新创建的结果的文件夹，或当前存储待覆盖项目的文件夹。
当选择覆盖输出方法时，文件项目参数可用。 使用此参数可浏览和选择要覆盖的项目。 您可以覆盖自己的项目或在共享更新群组中与您共享的项目。 如果所选项目类型为 GeoJSON 或 Apache Parquet，则可使用几何字段参数来指定覆盖现有文件时使用的输入数据集中的几何。
要安排文件自动更新，建议使用覆盖输出方法而不是如果项目已存在，则覆盖选项。
要修改项目属性，例如摘要或标签，请浏览到您的门户内容页面并直接编辑项目。
局限性
以下是文件输出的已知限制：
- CSV 文件输出始终为表格式。 要在 CSV 文件中存储几何的字符串表示，请使用更新字段工具将几何字段转换为字符串。 要在将数据集写入 CSV 文件前从该数据集中删除几何字段，请使用选择字段工具。
- GeoJSON 文件输出需要几何，且始终使用 WGS84 (4326) 坐标系存储几何，从而遵循官方 GeoJSON 规范。 如果几何字段使用了除 WGS84 (4326) 外的其他坐标系，在写入项目前将自动投影该字段。 如果坐标系是自定义 WKT 字符串，则其可能无法转换为 WGS 1984 (4326)。 请改用要素图层输出。
- Apache Parquet 文件输出始终将几何存储在二进制列中。 Apache Parquet 文件输出不支持部分自定义坐标系 (WKT)，因此文件可能无法写入。 请改用要素图层输出。
- 当写入失败时，覆盖操作不会回滚，这可能会导致该项目丢失，直到数据管道再次运行。
- 将结果写入文件时，并非输入源支持的所有字段类型都会得到保留。 字段类型将自动进行转换，以兼容所选文件格式。
- 除非您是管理员，或者文件已共享至您所在的共享更新群组，否则您无法对不属于自己的文件使用覆盖选项。
- 当组合使用创建和如果项目已存在，则覆盖输出选项时，以下限制适用：
- 对于计划或自动运行，建议不要使用此选项。 要实现更可靠的文件计划更新，请使用覆盖输出方法并显式浏览至要覆盖的文件项目值。
- 要覆盖的项目必须归您所有，且必须存储在指定文件夹。 如果其他文件夹中包含同名文件，则不会覆盖该文件。
- 当写入失败时，覆盖操作不会回滚，这可能会导致该项目丢失，直到数据管道再次运行。
许可要求
需要以下许可和配置：
- Creator 或 Professional 用户类型
- 发布者、服务商或管理员角色，或等效的自定义角色
有关 Data Pipelines 要求的详细信息，请参阅要求。
相关主题
有关附加信息，请参阅以下主题：
- 有关如何按照计划自动更新项目的详细信息，请参阅计划数据管道任务。
- 有关项目的详细信息，请参阅 ArcGIS Online 中受支持的项目。