Method: projects.locations.dataStores.branches.documents.import

object (ImportErrorConfig)

导入期间发生的错误的预期位置。

enum (ReconciliationMode)

现有文档与要导入的文档之间的协调模式。默认值为 ReconciliationMode.INCREMENTAL。

string (FieldMask format)

指示要更新所提供的导入文档中的哪些字段。如果未设置，则默认为更新所有字段。

这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。

boolean

指示是否在缺少 ID 的情况下自动为文档生成 ID。

如果设置为 true，系统会根据载荷的哈希值自动生成 Document.id，但多次导入期间 ID 可能不一致。在这种情况下，强烈建议使用 ReconciliationMode.FULL 以避免内容重复。如果未设置或设置为 false，则必须使用 idField 指定 Document.id，否则，没有 ID 的文档将无法导入。

支持的数据源：

• GcsSource：GcsSource.data_schema 必须为 custom 或 csv。否则，系统会抛出 INVALID_ARGUMENT 错误。
• BigQuerySource：BigQuerySource.data_schema 必须为 custom 或 csv。否则，系统会抛出 INVALID_ARGUMENT 错误。
• SpannerSource。
• CloudSqlSource。
• FirestoreSource。
• BigtableSource。

string

该字段指示要用作文档唯一 ID 的 ID 字段或列。

对于 GcsSource，它是 JSON 字段的键。例如，JSON {"my_id": "some_uuid"} 中的 my_id。对于其他数据来源，它可能是存储唯一 ID 的表的列名称。

JSON 字段或表列的值用作 Document.id。JSON 字段或表列必须为字符串类型，并且值必须设置为符合 RFC-1034 的有效字符串，长度为 1-63 个字符。否则，没有有效 ID 的文档将无法导入。

仅当 autoGenerateIds 未设置或设置为 false 时，才设置此字段。否则，系统会抛出 INVALID_ARGUMENT 错误。

如果未设置，则在从允许的数据源导入时使用默认值 Id。

支持的数据源：

• GcsSource：GcsSource.data_schema 必须为 custom 或 csv。否则，系统会抛出 INVALID_ARGUMENT 错误。
• BigQuerySource：BigQuerySource.data_schema 必须为 custom 或 csv。否则，系统会抛出 INVALID_ARGUMENT 错误。
• SpannerSource。
• CloudSqlSource。
• BigtableSource。

boolean

可选。指示是否强制刷新文档的非结构化内容。

如果设置为 true，则无论引用内容的更新状态如何，系统都会刷新文档的内容部分。

object (InlineSource)

文档的输入内容的内嵌来源。

object (GcsSource)

输入内容所在的 Cloud Storage 位置。

object (BigQuerySource)

BigQuery 输入来源。

object (FhirStoreSource)

FhirStore 输入来源。

object (SpannerSource)

Spanner 输入来源。

object (CloudSqlSource)

Cloud SQL 输入来源。

object (FirestoreSource)

Firestore 输入来源。

object (AlloyDbSource)

AlloyDB 输入来源。

object (BigtableSource)

Cloud Bigtable 输入来源。