An object that describes the values that you want to set for an
entry and its attached aspects when you import metadata. Used when
you run a metadata import job. See
CreateMetadataJob.
You provide a collection of import items in a metadata import file.
For more information about how to create a metadata import file, see
Metadata import
file <https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file>__.
google.protobuf.field_mask_pb2.FieldMask
The fields to update, in paths that are relative to the
Entry resource. Separate each field with a comma.
In FULL entry sync mode, Dataplex includes the paths of
all of the fields for an entry that can be modified,
including aspects. This means that Dataplex replaces the
existing entry with the entry in the metadata import file.
All modifiable fields are updated, regardless of the fields
that are listed in the update mask, and regardless of
whether a field is present in the entry object.
The update_mask field is ignored when an entry is
created or re-created.
In an aspect-only metadata job (when entry sync mode is
NONE), set this value to aspects.
Dataplex also determines which entries and aspects to modify
by comparing the values and timestamps that you provide in
the metadata import file with the values and timestamps that
exist in your project. For more information, see `Comparison
logic
aspect_keys
MutableSequence[str]
The aspects to modify. Supports the following syntaxes:
- {aspect_type_reference}: matches aspects that belong
to the specified aspect type and are attached directly to
the entry.
- {aspect_type_reference}@{path}: matches aspects that
belong to the specified aspect type and path.
- {aspect_type_reference}@* : matches aspects of the
given type for all paths.
- *@path : matches aspects of all types on the given
path.
Replace {aspect_type_reference} with a reference to the
aspect type, in the format
{project_id_or_number}.{location_id}.{aspect_type_id}.
In FULL entry sync mode, if you leave this field empty,
it is treated as specifying exactly those aspects that are
present within the specified entry. Dataplex implicitly adds
the keys for all of the required aspects of an entry.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class ImportItem (2.11.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.11.0 (latest)](/python/docs/reference/dataplex/latest/google.cloud.dataplex_v1.types.ImportItem)\n- [2.10.2](/python/docs/reference/dataplex/2.10.2/google.cloud.dataplex_v1.types.ImportItem)\n- [2.9.0](/python/docs/reference/dataplex/2.9.0/google.cloud.dataplex_v1.types.ImportItem)\n- [2.8.0](/python/docs/reference/dataplex/2.8.0/google.cloud.dataplex_v1.types.ImportItem)\n- [2.7.1](/python/docs/reference/dataplex/2.7.1/google.cloud.dataplex_v1.types.ImportItem)\n- [2.6.0](/python/docs/reference/dataplex/2.6.0/google.cloud.dataplex_v1.types.ImportItem)\n- [2.5.0](/python/docs/reference/dataplex/2.5.0/google.cloud.dataplex_v1.types.ImportItem)\n- [2.4.0](/python/docs/reference/dataplex/2.4.0/google.cloud.dataplex_v1.types.ImportItem)\n- [2.3.1](/python/docs/reference/dataplex/2.3.1/google.cloud.dataplex_v1.types.ImportItem)\n- [2.2.2](/python/docs/reference/dataplex/2.2.2/google.cloud.dataplex_v1.types.ImportItem)\n- [2.1.0](/python/docs/reference/dataplex/2.1.0/google.cloud.dataplex_v1.types.ImportItem)\n- [2.0.1](/python/docs/reference/dataplex/2.0.1/google.cloud.dataplex_v1.types.ImportItem)\n- [1.13.0](/python/docs/reference/dataplex/1.13.0/google.cloud.dataplex_v1.types.ImportItem)\n- [1.12.3](/python/docs/reference/dataplex/1.12.3/google.cloud.dataplex_v1.types.ImportItem)\n- [1.11.0](/python/docs/reference/dataplex/1.11.0/google.cloud.dataplex_v1.types.ImportItem)\n- [1.10.0](/python/docs/reference/dataplex/1.10.0/google.cloud.dataplex_v1.types.ImportItem)\n- [1.9.0](/python/docs/reference/dataplex/1.9.0/google.cloud.dataplex_v1.types.ImportItem)\n- [1.8.1](/python/docs/reference/dataplex/1.8.1/google.cloud.dataplex_v1.types.ImportItem)\n- [1.7.0](/python/docs/reference/dataplex/1.7.0/google.cloud.dataplex_v1.types.ImportItem)\n- [1.6.2](/python/docs/reference/dataplex/1.6.2/google.cloud.dataplex_v1.types.ImportItem)\n- [1.5.1](/python/docs/reference/dataplex/1.5.1/google.cloud.dataplex_v1.types.ImportItem)\n- [1.4.3](/python/docs/reference/dataplex/1.4.3/google.cloud.dataplex_v1.types.ImportItem)\n- [1.3.0](/python/docs/reference/dataplex/1.3.0/google.cloud.dataplex_v1.types.ImportItem)\n- [1.2.0](/python/docs/reference/dataplex/1.2.0/google.cloud.dataplex_v1.types.ImportItem)\n- [1.1.3](/python/docs/reference/dataplex/1.1.3/google.cloud.dataplex_v1.types.ImportItem)\n- [1.0.1](/python/docs/reference/dataplex/1.0.1/google.cloud.dataplex_v1.types.ImportItem)\n- [0.2.1](/python/docs/reference/dataplex/0.2.1/google.cloud.dataplex_v1.types.ImportItem)\n- [0.1.0](/python/docs/reference/dataplex/0.1.0/google.cloud.dataplex_v1.types.ImportItem) \n\n ImportItem(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nAn object that describes the values that you want to set for an\nentry and its attached aspects when you import metadata. Used when\nyou run a metadata import job. See\nCreateMetadataJob.\n\nYou provide a collection of import items in a metadata import file.\nFor more information about how to create a metadata import file, see\n`Metadata import\nfile \u003chttps://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file\u003e`__."]]