Module: Google::Cloud::Dataplex

Defined in:
lib/google/cloud/dataplex.rb,
lib/google/cloud/dataplex/version.rb

Constant Summary collapse

VERSION = 
"1.4.1"

Class Method Summary collapse

Class Method Details

.catalog_service(version: :v1, transport: :grpc, &block) ⇒ ::Object

Create a new client object for CatalogService.

By default, this returns an instance of Google::Cloud::Dataplex::V1::CatalogService::Client for a gRPC client for version V1 of the API. However, you can specify a different API version by passing it in the version parameter. If the CatalogService service is supported by that API version, and the corresponding gem is available, the appropriate versioned client will be returned. You can also specify a different transport by passing :rest or :grpc in the transport parameter.

About CatalogService

The primary resources offered by this service are EntryGroups, EntryTypes, AspectTypes, Entry and Aspect which collectively allow a data administrator to organize, manage, secure and catalog data across their organization located across cloud projects in a variety of storage systems including Cloud Storage and BigQuery.

Parameters:

  • version (::String, ::Symbol) (defaults to: :v1) —

    The API version to connect to. Optional. Defaults to :v1.

  • transport (:grpc, :rest) (defaults to: :grpc) —

    The transport to use. Defaults to :grpc.

Returns:

  • (::Object) —

    A client object for the specified version.



112
113
114
115
116
117
118
119
120
121
122
 
# File 'lib/google/cloud/dataplex.rb', line 112

def self.catalog_service version: :v1, transport: :grpc, &block
  require "google/cloud/dataplex/#{version.to_s.downcase}"

  package_name = Google::Cloud::Dataplex
                 .constants
                 .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                 .first
  service_module = Google::Cloud::Dataplex.const_get(package_name).const_get(:CatalogService)
  service_module = service_module.const_get(:Rest) if transport == :rest
  service_module.const_get(:Client).new(&block)
end

.configure {|::Google::Cloud.configure.dataplex| ... } ⇒ ::Google::Cloud::Config

Configure the google-cloud-dataplex library.

The following configuration parameters are supported:

  • credentials (type: String, Hash, Google::Auth::Credentials) - The path to the keyfile as a String, the contents of the keyfile as a Hash, or a Google::Auth::Credentials object.
  • lib_name (type: String) - The library name as recorded in instrumentation and logging.
  • lib_version (type: String) - The library version as recorded in instrumentation and logging.
  • interceptors (type: Array<GRPC::ClientInterceptor>) - An array of interceptors that are run before calls are executed.
  • timeout (type: Numeric) - Default timeout in seconds.
  • metadata (type: Hash{Symbol=>String}) - Additional headers to be sent with the call.
  • retry_policy (type: Hash) - The retry policy. The value is a hash with the following keys:
    • :initial_delay (type: Numeric) - The initial delay in seconds.
    • :max_delay (type: Numeric) - The max delay in seconds.
    • :multiplier (type: Numeric) - The incremental backoff multiplier.
    • :retry_codes (type: Array<String>) - The error codes that should trigger a retry.

Yields:

Returns:

  • (::Google::Cloud::Config) —

    The default configuration used by this library



292
293
294
295
296
 
# File 'lib/google/cloud/dataplex.rb', line 292

def self.configure
  yield ::Google::Cloud.configure.dataplex if block_given?

  ::Google::Cloud.configure.dataplex
end

.content_service(version: :v1, transport: :grpc, &block) ⇒ ::Object

Create a new client object for ContentService.

By default, this returns an instance of Google::Cloud::Dataplex::V1::ContentService::Client for a gRPC client for version V1 of the API. However, you can specify a different API version by passing it in the version parameter. If the ContentService service is supported by that API version, and the corresponding gem is available, the appropriate versioned client will be returned. You can also specify a different transport by passing :rest or :grpc in the transport parameter.

About ContentService

ContentService manages Notebook and SQL Scripts for Dataplex.

Parameters:

  • version (::String, ::Symbol) (defaults to: :v1) —

    The API version to connect to. Optional. Defaults to :v1.

  • transport (:grpc, :rest) (defaults to: :grpc) —

    The transport to use. Defaults to :grpc.

Returns:

  • (::Object) —

    A client object for the specified version.



146
147
148
149
150
151
152
153
154
155
156
 
# File 'lib/google/cloud/dataplex.rb', line 146

def self.content_service version: :v1, transport: :grpc, &block
  require "google/cloud/dataplex/#{version.to_s.downcase}"

  package_name = Google::Cloud::Dataplex
                 .constants
                 .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                 .first
  service_module = Google::Cloud::Dataplex.const_get(package_name).const_get(:ContentService)
  service_module = service_module.const_get(:Rest) if transport == :rest
  service_module.const_get(:Client).new(&block)
end

.data_scan_service(version: :v1, transport: :grpc, &block) ⇒ ::Object

Create a new client object for DataScanService.

By default, this returns an instance of Google::Cloud::Dataplex::V1::DataScanService::Client for a gRPC client for version V1 of the API. However, you can specify a different API version by passing it in the version parameter. If the DataScanService service is supported by that API version, and the corresponding gem is available, the appropriate versioned client will be returned. You can also specify a different transport by passing :rest or :grpc in the transport parameter.

About DataScanService

DataScanService manages DataScan resources which can be configured to run various types of data scanning workload and generate enriched metadata (e.g. Data Profile, Data Quality) for the data source.

Parameters:

  • version (::String, ::Symbol) (defaults to: :v1) —

    The API version to connect to. Optional. Defaults to :v1.

  • transport (:grpc, :rest) (defaults to: :grpc) —

    The transport to use. Defaults to :grpc.

Returns:

  • (::Object) —

    A client object for the specified version.



217
218
219
220
221
222
223
224
225
226
227
 
# File 'lib/google/cloud/dataplex.rb', line 217

def self.data_scan_service version: :v1, transport: :grpc, &block
  require "google/cloud/dataplex/#{version.to_s.downcase}"

  package_name = Google::Cloud::Dataplex
                 .constants
                 .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                 .first
  service_module = Google::Cloud::Dataplex.const_get(package_name).const_get(:DataScanService)
  service_module = service_module.const_get(:Rest) if transport == :rest
  service_module.const_get(:Client).new(&block)
end

.data_taxonomy_service(version: :v1, transport: :grpc, &block) ⇒ ::Object

Create a new client object for DataTaxonomyService.

By default, this returns an instance of Google::Cloud::Dataplex::V1::DataTaxonomyService::Client for a gRPC client for version V1 of the API. However, you can specify a different API version by passing it in the version parameter. If the DataTaxonomyService service is supported by that API version, and the corresponding gem is available, the appropriate versioned client will be returned. You can also specify a different transport by passing :rest or :grpc in the transport parameter.

About DataTaxonomyService

DataTaxonomyService enables attribute-based governance. The resources currently offered include DataTaxonomy and DataAttribute.

Parameters:

  • version (::String, ::Symbol) (defaults to: :v1) —

    The API version to connect to. Optional. Defaults to :v1.

  • transport (:grpc, :rest) (defaults to: :grpc) —

    The transport to use. Defaults to :grpc.

Returns:

  • (::Object) —

    A client object for the specified version.



181
182
183
184
185
186
187
188
189
190
191
 
# File 'lib/google/cloud/dataplex.rb', line 181

def self.data_taxonomy_service version: :v1, transport: :grpc, &block
  require "google/cloud/dataplex/#{version.to_s.downcase}"

  package_name = Google::Cloud::Dataplex
                 .constants
                 .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                 .first
  service_module = Google::Cloud::Dataplex.const_get(package_name).const_get(:DataTaxonomyService)
  service_module = service_module.const_get(:Rest) if transport == :rest
  service_module.const_get(:Client).new(&block)
end

.dataplex_service(version: :v1, transport: :grpc, &block) ⇒ ::Object

Create a new client object for DataplexService.

By default, this returns an instance of Google::Cloud::Dataplex::V1::DataplexService::Client for a gRPC client for version V1 of the API. However, you can specify a different API version by passing it in the version parameter. If the DataplexService service is supported by that API version, and the corresponding gem is available, the appropriate versioned client will be returned. You can also specify a different transport by passing :rest or :grpc in the transport parameter.

About DataplexService

Dataplex service provides data lakes as a service. The primary resources offered by this service are Lakes, Zones and Assets which collectively allow a data administrator to organize, manage, secure and catalog data across their organization located across cloud projects in a variety of storage systems including Cloud Storage and BigQuery.

Parameters:

  • version (::String, ::Symbol) (defaults to: :v1) —

    The API version to connect to. Optional. Defaults to :v1.

  • transport (:grpc, :rest) (defaults to: :grpc) —

    The transport to use. Defaults to :grpc.

Returns:

  • (::Object) —

    A client object for the specified version.



74
75
76
77
78
79
80
81
82
83
84
 
# File 'lib/google/cloud/dataplex.rb', line 74

def self.dataplex_service version: :v1, transport: :grpc, &block
  require "google/cloud/dataplex/#{version.to_s.downcase}"

  package_name = Google::Cloud::Dataplex
                 .constants
                 .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                 .first
  service_module = Google::Cloud::Dataplex.const_get(package_name).const_get(:DataplexService)
  service_module = service_module.const_get(:Rest) if transport == :rest
  service_module.const_get(:Client).new(&block)
end

.metadata_service(version: :v1, transport: :grpc, &block) ⇒ ::Object

Create a new client object for MetadataService.

By default, this returns an instance of Google::Cloud::Dataplex::V1::MetadataService::Client for a gRPC client for version V1 of the API. However, you can specify a different API version by passing it in the version parameter. If the MetadataService service is supported by that API version, and the corresponding gem is available, the appropriate versioned client will be returned. You can also specify a different transport by passing :rest or :grpc in the transport parameter.

About MetadataService

Metadata service manages metadata resources such as tables, filesets and partitions.

Parameters:

  • version (::String, ::Symbol) (defaults to: :v1) —

    The API version to connect to. Optional. Defaults to :v1.

  • transport (:grpc, :rest) (defaults to: :grpc) —

    The transport to use. Defaults to :grpc.

Returns:

  • (::Object) —

    A client object for the specified version.



252
253
254
255
256
257
258
259
260
261
262
 
# File 'lib/google/cloud/dataplex.rb', line 252

def self.metadata_service version: :v1, transport: :grpc, &block
  require "google/cloud/dataplex/#{version.to_s.downcase}"

  package_name = Google::Cloud::Dataplex
                 .constants
                 .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
                 .first
  service_module = Google::Cloud::Dataplex.const_get(package_name).const_get(:MetadataService)
  service_module = service_module.const_get(:Rest) if transport == :rest
  service_module.const_get(:Client).new(&block)
end