airflow.providers.google.cloud.hooks.datacatalog

CloudDataCatalogHook

Google Cloud Data Catalog 服务的 Hook。

模块内容

class airflow.providers.google.cloud.hooks.datacatalog.CloudDataCatalogHook(gcp_conn_id='google_cloud_default', impersonation_chain=None, **kwargs)[source]

基类: airflow.providers.google.common.hooks.base_google.GoogleBaseHook

Google Cloud Data Catalog 服务的 Hook。

参数:
  • gcp_conn_id (str) – 获取连接信息时使用的连接 ID。

  • impersonation_chain (str | collections.abc.Sequence[str] | None) – 可选的服务账号,用于使用短期凭据进行模拟,或者获取列表中最后一个账号的 access_token 所需的链式账号列表,该账号将在请求中被模拟。如果设置为字符串,该账号必须授予原始账号 Service Account Token Creator IAM 角色。如果设置为序列,列表中的身份必须将其直接前一个身份授予 Service Account Token Creator IAM 角色,列表中第一个账号将此角色授予原始账号。

get_conn()[source]

检索允许访问 Cloud Data Catalog 服务的客户端库对象。

create_entry(location, entry_group, entry_id, entry, project_id=PROVIDE_PROJECT_ID, retry=DEFAULT, timeout=None, metadata=())[source]

创建条目。

目前只能创建类型为 ‘FILESET’ 的条目。

参数:
  • location (str) – 必需。要创建的条目的位置。

  • entry_group (str) – 必需。创建条目时所在的条目组 ID。

  • entry_id (str) – 必需。要创建的条目的 ID。

  • entry (dict | google.cloud.datacatalog.Entry) – 必需。要创建的条目。如果提供字典,其形式必须与 protobuf 消息 Entry 相同

  • project_id (str) – 拥有该条目的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果设置为 None 或缺失,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

create_entry_group(location, entry_group_id, entry_group, project_id=PROVIDE_PROJECT_ID, retry=DEFAULT, timeout=None, metadata=())[source]

创建 EntryGroup。

参数:
  • location (str) – 必需。要创建的条目组的位置。

  • entry_group_id (str) – 必需。要创建的条目组的 ID。ID 必须以字母或下划线开头,只能包含英文字母、数字和下划线,并且长度最多为 64 个字符。

  • entry_group (dict | google.cloud.datacatalog.EntryGroup) –

    要创建的条目组。默认为一个空的条目组。

    如果提供字典,其形式必须与 protobuf 消息 EntryGroup 相同

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

create_tag(location, entry_group, entry, tag, project_id=PROVIDE_PROJECT_ID, template_id=None, retry=DEFAULT, timeout=None, metadata=())[source]

在条目上创建标签。

参数:
  • location (str) – 必需。要创建的标签的位置。

  • entry_group (str) – 必需。创建标签时所在的条目组 ID。

  • entry (str) – 必需。创建标签时所在的条目组 ID。

  • tag (dict | google.cloud.datacatalog.Tag) – 必需。要创建的标签。如果提供字典,其形式必须与 protobuf 消息 Tag 相同

  • template_id (str | None) – 必需。用于创建标签的模板 ID

  • project_id (str) – 拥有该标签的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

create_tag_template(location, tag_template_id, tag_template, project_id=PROVIDE_PROJECT_ID, retry=DEFAULT, timeout=None, metadata=())[source]

创建标签模板。

参数:
  • location – 必需。要创建的标签模板的位置。

  • tag_template_id (str) – 必需。要创建的标签模板的 ID。

  • tag_template (dict | google.cloud.datacatalog.TagTemplate) –

    必需。要创建的标签模板。

    如果提供字典,其形式必须与 protobuf 消息 TagTemplate 相同

  • project_id (str) – 拥有该标签模板的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

create_tag_template_field(location, tag_template, tag_template_field_id, tag_template_field, project_id=PROVIDE_PROJECT_ID, retry=DEFAULT, timeout=None, metadata=())[source]

在标签模板中创建字段。

参数:
  • location (str) – 必需。要创建的标签模板字段的位置。

  • tag_template (str) – 必需。要创建的标签模板的 ID。

  • tag_template_field_id (str) – 必需。要创建的标签模板字段的 ID。字段 ID 可以包含字母(大小写)、数字 (0-9)、下划线 (_) 和破折号 (-)。字段 ID 必须至少 1 个字符长,最多 128 个字符长。字段 ID 在其模板内也必须是唯一的。

  • tag_template_field (dict | google.cloud.datacatalog.TagTemplateField) –

    必需。要创建的标签模板字段。

    如果提供字典,其形式必须与 protobuf 消息 TagTemplateField 相同

  • project_id (str) – 拥有该标签模板字段的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

delete_entry(location, entry_group, entry, project_id=PROVIDE_PROJECT_ID, retry=DEFAULT, timeout=None, metadata=())[source]

删除现有条目。

参数:
  • location (str) – 必需。要删除的条目的位置。

  • entry_group (str) – 必需。要删除的条目所在的条目组 ID。

  • entry (str) – 要删除的条目的 ID。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

delete_entry_group(location, entry_group, project_id=PROVIDE_PROJECT_ID, retry=DEFAULT, timeout=None, metadata=())[source]

删除 EntryGroup。

只能删除不包含条目的条目组。

参数:
  • location – 必需。要删除的条目组的位置。

  • entry_group – 要删除的条目组 ID。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

delete_tag(location, entry_group, entry, tag, project_id=PROVIDE_PROJECT_ID, retry=DEFAULT, timeout=None, metadata=())[source]

删除标签。

参数:
  • location (str) – 必需。要删除的标签的位置。

  • entry_group (str) – 要删除的标签所在的条目组 ID。

  • entry (str) – 要删除的标签所在的条目 ID。

  • tag (str) – 要删除的标签的标识符。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

delete_tag_template(location, tag_template, force, project_id, retry=DEFAULT, timeout=None, metadata=())[source]

删除标签模板以及所有使用该模板的标签。

参数:
  • location – 必需。要删除的标签模板的位置。

  • tag_template – 要删除的标签模板的 ID。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • force (bool) – 必需。目前,此字段必须始终设置为 true。这确认删除所有可能使用此模板的标签。force = false 将来会支持。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

delete_tag_template_field(location, tag_template, field, force, project_id, retry=DEFAULT, timeout=None, metadata=())[source]

删除标签模板中的字段以及该字段的所有使用。

参数:
  • location (str) – 必需。要删除的标签模板的位置。

  • tag_template (str) – 要删除的标签模板字段的标签模板 ID。

  • field (str) – 要删除的字段名称。

  • force (bool) – 必需。这确认从使用此字段的所有标签中删除该字段。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

get_entry(location, entry_group, entry, project_id, retry=DEFAULT, timeout=None, metadata=())[source]

获取条目。

参数:
  • location (str) – 必需。要获取的条目的位置。

  • entry_group (str) – 必需。要获取的条目的条目组。

  • entry (str) – 要获取的条目的 ID。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

get_entry_group(location, entry_group, project_id, read_mask=None, retry=DEFAULT, timeout=None, metadata=())[source]

获取条目组。

参数:
  • location (str) – 必需。要获取的条目组的位置。

  • entry_group (str) – 要获取的条目组的 ID。

  • read_mask (google.protobuf.field_mask_pb2.FieldMask | None) –

    要返回的字段。如果未设置或为空,则返回所有字段。

    如果提供字典,其形式必须与 protobuf 消息 FieldMask 相同

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

get_tag_template(location, tag_template, project_id, retry=DEFAULT, timeout=None, metadata=())[source]

获取标签模板。

参数:
  • location (str) – 必需。要获取的标签模板的位置。

  • tag_template (str) – 必需。要获取的标签模板的 ID。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

list_tags(location, entry_group, entry, project_id, page_size=100, retry=DEFAULT, timeout=None, metadata=())[source]

列出 Entry 上的标签。

参数:
  • location (str) – 必需。要获取的标签的位置。

  • entry_group (str) – 必需。要获取的标签所在的条目组。

  • entry_group – 必需。要获取的标签所在的条目。

  • page_size (int) – 底层 API 响应中包含的最大资源数量。如果按资源进行分页流,此参数不影响返回值。如果按页进行分页流,此参数确定每页中的最大资源数量。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

get_tag_for_template_name(location, entry_group, entry, template_name, project_id, retry=DEFAULT, timeout=None, metadata=())[source]

获取特定条目中具有特定模板的标签。

参数:
  • location (str) – 必需。包含要搜索的条目的位置。

  • entry_group (str) – 包含要搜索的条目的条目组 ID。

  • entry (str) – 要搜索的条目名称。

  • template_name (str) – 将作为搜索条件的模板名称。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

lookup_entry(linked_resource=None, sql_resource=None, retry=DEFAULT, timeout=None, metadata=())[source]

按目标资源名称获取条目。

此方法允许客户端使用源 Google Cloud 服务中的资源名称获取 Data Catalog 条目。

参数:
  • linked_resource (str | None) – Data Catalog 条目所代表的 Google Cloud 资源的完整名称。参见:https://cloud.google.com/apis/design/resource_names#full_resource_name。完整名称区分大小写。

  • sql_resource (str | None) – 条目的 SQL 名称。SQL 名称区分大小写。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

rename_tag_template_field(location, tag_template, field, new_tag_template_field_id, project_id, retry=DEFAULT, timeout=None, metadata=())[source]

重命名标签模板中的字段。

参数:
  • location (str) – 必需。要重命名的标签模板字段所在的位置。

  • tag_template (str) – 要重命名的字段所属的标签模板 ID。

  • field (str) – 必需。此标签模板字段的旧 ID。例如,my_old_field

  • new_tag_template_field_id (str) – 必需。此标签模板字段的新 ID。例如,my_new_field

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

search_catalog(scope, query, page_size=100, order_by=None, retry=DEFAULT, timeout=None, metadata=())[source]

在 Data Catalog 中搜索与查询匹配的多个资源,例如条目、标签。

此方法不返回完整的资源,只返回资源标识符和高级字段。客户端随后可以调用 Get 方法。

请注意,搜索无法完全召回所有结果。可能存在与您的查询匹配但未返回的结果,即使在后续的结果页面中也是如此。这些缺失的结果在重复调用搜索时可能有所不同。如果您需要保证完全召回,请勿依赖此方法。

参数:
  • scope (dict | google.cloud.datacatalog.SearchCatalogRequest.Scope) –

    必需。此搜索请求的范围。

    如果提供字典,则其形式必须与 protobuf 消息 Scope 相同

  • query (str) –

    必需。采用搜索查询语法的查询字符串。查询必须非空。

    查询字符串可以像“x”一样简单,也可以更限定为

    • name:x

    • column:x

    • description:y

    注意:查询标记需要至少包含 3 个字符才能正确进行子字符串匹配。参见 Data Catalog 搜索语法 以获取更多信息。

  • page_size (int) – 基础 API 响应中包含的最大资源数量。如果按资源执行页面流式传输,此参数不会影响返回值。如果按页面执行页面流式传输,此参数确定页面中的最大资源数量。

  • order_by (str | None) –

    指定结果的排序,目前支持的区分大小写的选项有

    • relevance,仅支持降序

    • last_access_timestamp [asc|desc],如果未指定,默认为降序

    • last_modified_timestamp [asc|desc],如果未指定,默认为降序

    如果未指定,默认为 relevance 降序。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

update_entry(entry, update_mask, project_id, location=None, entry_group=None, entry_id=None, retry=DEFAULT, timeout=None, metadata=())[source]

更新现有条目。

参数:
  • entry (dict | google.cloud.datacatalog.Entry) –

    必需。更新后的条目。“name”字段必须设置。

    如果提供字典,则其形式必须与 protobuf 消息 Entry 相同

  • update_mask (dict | google.protobuf.field_mask_pb2.FieldMask) –

    要更新的条目字段。如果缺失或为空,则更新所有可修改字段。

    如果提供字典,其形式必须与 protobuf 消息 FieldMask 相同

  • location (str | None) – 必需。要更新的条目所在的位置。

  • entry_group (str | None) – 要更新的条目所属的条目组 ID。

  • entry_id (str | None) – 正在更新的条目 ID。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

update_tag(tag, update_mask, project_id, location=None, entry_group=None, entry=None, tag_id=None, retry=DEFAULT, timeout=None, metadata=())[source]

更新现有标签。

参数:
  • tag (dict | google.cloud.datacatalog.Tag) –

    必需。更新后的标签。“name”字段必须设置。

    如果提供字典,则其形式必须与 protobuf 消息 Tag 相同

  • update_mask (dict | google.protobuf.field_mask_pb2.FieldMask) –

    要更新的标签字段。如果缺失或为空,则更新所有可修改字段。目前唯一可修改的字段是 fields 字段。

    如果提供字典,其形式必须与 protobuf 消息 FieldMask 相同

  • location (str | None) – 必需。要更新的标签所在的位置。

  • entry_group (str | None) – 正在更新的标签所属的条目组 ID。

  • entry (str | None) – 正在更新的标签所属的条目 ID。

  • tag_id (str | None) – 正在更新的标签 ID。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

update_tag_template(tag_template, update_mask, project_id, location=None, tag_template_id=None, retry=DEFAULT, timeout=None, metadata=())[source]

更新标签模板。

此方法无法用于更新模板的字段。标签模板字段表示为单独的资源,应使用其各自的创建/更新/删除方法进行更新。

参数:
  • tag_template (dict | google.cloud.datacatalog.TagTemplate) –

    必需。要更新的模板。“name”字段必须设置。

    如果提供字典,其形式必须与 protobuf 消息 TagTemplate 相同

  • update_mask (dict | google.protobuf.field_mask_pb2.FieldMask) –

    字段掩码指定要覆盖的模板部分。

    如果缺失或为空,则将更新上述所有允许的字段。

    如果提供字典,其形式必须与 protobuf 消息 FieldMask 相同

  • location (str | None) – 必需。要更新的标签模板所在的位置。

  • tag_template_id (str | None) – 可选。正在更新的标签模板 ID。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

update_tag_template_field(tag_template_field, update_mask, project_id, tag_template_field_name=None, location=None, tag_template=None, tag_template_field_id=None, retry=DEFAULT, timeout=None, metadata=())[source]

更新标签模板中的字段。此方法无法用于更新字段类型。

参数:
  • tag_template_field (dict | google.cloud.datacatalog.TagTemplateField) –

    必需。要更新的标签模板字段。

    如果提供字典,其形式必须与 protobuf 消息 TagTemplateField 相同

  • update_mask (dict | google.protobuf.field_mask_pb2.FieldMask) –

    字段掩码指定要更新的标签模板字段的部分。允许的字段

    • display_name

    • type.enum_type

    如果 update_mask 未设置或为空,则将更新上述所有允许的字段。

    更新枚举类型时,提供的值将与现有值合并。因此,只能添加枚举值,不能删除或重命名现有枚举值。

    如果提供字典,其形式必须与 protobuf 消息 FieldMask 相同

  • tag_template_field_name (str | None) – 可选。要更新的标签模板字段的名称。

  • location (str | None) – 可选。要更新的标签模板字段所在的位置。

  • tag_template (str | None) – 可选。要更新的标签模板字段所属的标签模板 ID。

  • tag_template_field_id (str | None) – 可选。要更新的标签模板字段的 ID。

  • project_id (str) – 拥有该条目组的 Google Cloud 项目 ID。如果设置为 None 或缺失,则使用 Google Cloud 连接中的默认 project_id。

  • retry (google.api_core.retry.Retry | google.api_core.gapic_v1.method._MethodDefault) – 用于重试请求的重试对象。如果指定为 None,将使用默认配置重试请求。

  • timeout (float | None) – 等待请求完成的超时时间,单位为秒。请注意,如果指定了 retry,则超时应用于每个单独的尝试。

  • metadata (collections.abc.Sequence[tuple[str, str]]) – 提供给方法的附加元数据。

此条目是否有用?