Class: Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1Entry

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
lib/google/apis/datacatalog_v1beta1/classes.rb,
lib/google/apis/datacatalog_v1beta1/representations.rb,
lib/google/apis/datacatalog_v1beta1/representations.rb

Overview

Entry metadata. A Data Catalog entry represents another resource in Google Cloud Platform (such as a BigQuery dataset or a Pub/Sub topic) or outside of it. You can use the linked_resource field in the entry resource to refer to the original resource ID of the source system. An entry resource contains resource details, for example, its schema. Additionally, you can attach flexible metadata to an entry in the form of a Tag.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ GoogleCloudDatacatalogV1Entry

Returns a new instance of GoogleCloudDatacatalogV1Entry.



1116
1117
1118
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1116

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#bigquery_date_sharded_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1BigQueryDateShardedSpec

Specification for a group of BigQuery tables with the [prefix]YYYYMMDD name pattern. For more information, see Introduction to partitioned tables. Corresponds to the JSON property bigqueryDateShardedSpec

Returns:



934
935
936
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 934

def bigquery_date_sharded_spec
  @bigquery_date_sharded_spec
end

#bigquery_table_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1BigQueryTableSpec

Describes a BigQuery table. Corresponds to the JSON property bigqueryTableSpec

Returns:



939
940
941
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 939

def bigquery_table_spec
  @bigquery_table_spec
end

#business_context ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1BusinessContext

Business Context of the entry. Corresponds to the JSON property businessContext

Returns:



944
945
946
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 944

def business_context
  @business_context
end

#cloud_bigtable_system_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1CloudBigtableSystemSpec

Specification that applies to all entries that are part of CLOUD_BIGTABLE system (user_specified_type) Corresponds to the JSON property cloudBigtableSystemSpec

Returns:



950
951
952
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 950

def cloud_bigtable_system_spec
  @cloud_bigtable_system_spec
end

#data_source ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1DataSource

Physical location of an entry. Corresponds to the JSON property dataSource

Returns:



955
956
957
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 955

def data_source
  @data_source
end

#data_source_connection_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1DataSourceConnectionSpec

Specification that applies to a data source connection. Valid only for entries with the DATA_SOURCE_CONNECTION type. Only one of internal specs can be set at the time, and cannot be changed later. Corresponds to the JSON property dataSourceConnectionSpec

Returns:



962
963
964
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 962

def data_source_connection_spec
  @data_source_connection_spec
end

#database_table_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1DatabaseTableSpec

Specification that applies to a table resource. Valid only for entries with the TABLE type. Corresponds to the JSON property databaseTableSpec

Returns:



968
969
970
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 968

def database_table_spec
  @database_table_spec
end

#description ⇒ String

Entry description that can consist of several sentences or paragraphs that describe entry contents. The description must not contain Unicode non- characters as well as C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). The maximum size is 2000 bytes when encoded in UTF-8. Default value is an empty string. Corresponds to the JSON property description

Returns:

  • (String) 


977
978
979
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 977

def description
  @description
end

#display_name ⇒ String

Display name of an entry. The maximum size is 500 bytes when encoded in UTF-8. Default value is an empty string. Corresponds to the JSON property displayName

Returns:

  • (String) 


983
984
985
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 983

def display_name
  @display_name
end

#fileset_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1FilesetSpec

Specification that applies to a fileset. Valid only for entries with the ' FILESET' type. Corresponds to the JSON property filesetSpec

Returns:



989
990
991
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 989

def fileset_spec
  @fileset_spec
end

#fully_qualified_name ⇒ String

Fully qualified name (FQN) of the resource. Set automatically for entries representing resources from synced systems. Settable only during creation and read-only afterwards. Can be used for search and lookup of the entries. FQNs take two forms: * For non-regionalized resources: SYSTEM`:`PROJECT`.` PATH_TO_RESOURCE_SEPARATED_WITH_DOTS * For regionalized resources: SYSTEM`: `PROJECT`.`LOCATION_ID`.`PATH_TO_RESOURCE_SEPARATED_WITH_DOTS Example for a DPMS table: dataproc_metastore:PROJECT_ID.LOCATION_ID.INSTANCE_ID. DATABASE_ID.TABLE_ID` Corresponds to the JSON propertyfullyQualifiedName`

Returns:

  • (String) 


1001
1002
1003
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1001

def fully_qualified_name
  @fully_qualified_name
end

#gcs_fileset_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1GcsFilesetSpec

Describes a Cloud Storage fileset entry. Corresponds to the JSON property gcsFilesetSpec

Returns:



1006
1007
1008
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1006

def gcs_fileset_spec
  @gcs_fileset_spec
end

#integrated_system ⇒ String

Output only. Indicates the entry's source system that Data Catalog integrates with, such as BigQuery, Pub/Sub, or Dataproc Metastore. Corresponds to the JSON property integratedSystem

Returns:

  • (String) 


1012
1013
1014
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1012

def integrated_system
  @integrated_system
end

#labels ⇒ Hash<String,String>

Cloud labels attached to the entry. In Data Catalog, you can create and modify labels attached only to custom entries. Synced entries have unmodifiable labels that come from the source system. Corresponds to the JSON property labels

Returns:

  • (Hash<String,String>) 


1019
1020
1021
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1019

def labels
  @labels
end

#linked_resource ⇒ String

The resource this metadata entry refers to. For Google Cloud Platform resources, linked_resource is the Full Resource Name. For example, the linked_resource for a table resource from BigQuery is: //bigquery.googleapis. com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID`Output only when the entry is one of the types in theEntryTypeenum. For entries with a user_specified_type`, this field is optional and defaults to an empty string. The resource string must contain only letters (a-z, A-Z), numbers (0-9), underscores (_), periods (.), colons (:), slashes (/), dashes (-), and hashes (

). The maximum size is 200 bytes when encoded in UTF-8.

Corresponds to the JSON property linkedResource

Returns:

  • (String) 


1033
1034
1035
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1033

def linked_resource
  @linked_resource
end

#looker_system_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1LookerSystemSpec

Specification that applies to entries that are part LOOKER system ( user_specified_type) Corresponds to the JSON property lookerSystemSpec

Returns:



1039
1040
1041
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1039

def looker_system_spec
  @looker_system_spec
end

#name ⇒ String

Output only. The resource name of an entry in URL format. Note: The entry itself and its child resources might not be stored in the location specified in its name. Corresponds to the JSON property name

Returns:

  • (String) 


1046
1047
1048
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1046

def name
  @name
end

#personal_details ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1PersonalDetails

Entry metadata relevant only to the user and private to them. Corresponds to the JSON property personalDetails

Returns:



1051
1052
1053
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1051

def personal_details
  @personal_details
end

#routine_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1RoutineSpec

Specification that applies to a routine. Valid only for entries with the ROUTINE type. Corresponds to the JSON property routineSpec

Returns:



1057
1058
1059
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1057

def routine_spec
  @routine_spec
end

#schema ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1Schema

Represents a schema, for example, a BigQuery, GoogleSQL, or Avro schema. Corresponds to the JSON property schema

Returns:



1062
1063
1064
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1062

def schema
  @schema
end

#service_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1ServiceSpec

Specification that applies to a Service resource. Valid only for entries with the SERVICE type. Corresponds to the JSON property serviceSpec

Returns:



1068
1069
1070
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1068

def service_spec
  @service_spec
end

#source_system_timestamps ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1SystemTimestamps

Timestamps associated with this resource in a particular system. Corresponds to the JSON property sourceSystemTimestamps

Returns:



1073
1074
1075
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1073

def source_system_timestamps
  @source_system_timestamps
end

#sql_database_system_spec ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1SqlDatabaseSystemSpec

Specification that applies to entries that are part SQL_DATABASE system ( user_specified_type) Corresponds to the JSON property sqlDatabaseSystemSpec

Returns:



1079
1080
1081
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1079

def sql_database_system_spec
  @sql_database_system_spec
end

#type ⇒ String

The type of the entry. Only used for entries with types listed in the EntryType enum. Currently, only FILESET enum value is allowed. All other entries created in Data Catalog must use the user_specified_type. Corresponds to the JSON property type

Returns:

  • (String) 


1086
1087
1088
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1086

def type
  @type
end

#usage_signal ⇒ Google::Apis::DatacatalogV1beta1::GoogleCloudDatacatalogV1UsageSignal

The set of all usage signals that Data Catalog stores. Note: Usually, these signals are updated daily. In rare cases, an update may fail but will be performed again on the next day. Corresponds to the JSON property usageSignal

Returns:



1093
1094
1095
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1093

def usage_signal
  @usage_signal
end

#user_specified_system ⇒ String

Indicates the entry's source system that Data Catalog doesn't automatically integrate with. The user_specified_system string has the following limitations: * Is case insensitive. * Must begin with a letter or underscore. * Can only contain letters, numbers, and underscores. * Must be at least 1 character and at most 64 characters long. Corresponds to the JSON property userSpecifiedSystem

Returns:

  • (String) 


1102
1103
1104
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1102

def user_specified_system
  @user_specified_system
end

#user_specified_type ⇒ String

Custom entry type that doesn't match any of the values allowed for input and listed in the EntryType enum. When creating an entry, first check the type values in the enum. If there are no appropriate types for the new entry, provide a custom value, for example, my_special_type. The user_specified_type string has the following limitations: * Is case insensitive. * Must begin with a letter or underscore. * Can only contain letters, numbers, and underscores. * Must be at least 1 character and at most 64 characters long. Corresponds to the JSON property userSpecifiedType

Returns:

  • (String) 


1114
1115
1116
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1114

def user_specified_type
  @user_specified_type
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
 
# File 'lib/google/apis/datacatalog_v1beta1/classes.rb', line 1121

def update!(**args)
  @bigquery_date_sharded_spec = args[:bigquery_date_sharded_spec] if args.key?(:bigquery_date_sharded_spec)
  @bigquery_table_spec = args[:bigquery_table_spec] if args.key?(:bigquery_table_spec)
  @business_context = args[:business_context] if args.key?(:business_context)
  @cloud_bigtable_system_spec = args[:cloud_bigtable_system_spec] if args.key?(:cloud_bigtable_system_spec)
  @data_source = args[:data_source] if args.key?(:data_source)
  @data_source_connection_spec = args[:data_source_connection_spec] if args.key?(:data_source_connection_spec)
  @database_table_spec = args[:database_table_spec] if args.key?(:database_table_spec)
  @description = args[:description] if args.key?(:description)
  @display_name = args[:display_name] if args.key?(:display_name)
  @fileset_spec = args[:fileset_spec] if args.key?(:fileset_spec)
  @fully_qualified_name = args[:fully_qualified_name] if args.key?(:fully_qualified_name)
  @gcs_fileset_spec = args[:gcs_fileset_spec] if args.key?(:gcs_fileset_spec)
  @integrated_system = args[:integrated_system] if args.key?(:integrated_system)
  @labels = args[:labels] if args.key?(:labels)
  @linked_resource = args[:linked_resource] if args.key?(:linked_resource)
  @looker_system_spec = args[:looker_system_spec] if args.key?(:looker_system_spec)
  @name = args[:name] if args.key?(:name)
  @personal_details = args[:personal_details] if args.key?(:personal_details)
  @routine_spec = args[:routine_spec] if args.key?(:routine_spec)
  @schema = args[:schema] if args.key?(:schema)
  @service_spec = args[:service_spec] if args.key?(:service_spec)
  @source_system_timestamps = args[:source_system_timestamps] if args.key?(:source_system_timestamps)
  @sql_database_system_spec = args[:sql_database_system_spec] if args.key?(:sql_database_system_spec)
  @type = args[:type] if args.key?(:type)
  @usage_signal = args[:usage_signal] if args.key?(:usage_signal)
  @user_specified_system = args[:user_specified_system] if args.key?(:user_specified_system)
  @user_specified_type = args[:user_specified_type] if args.key?(:user_specified_type)
end