google-cloud-datastore-admin 0.1.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +1 -27
- data/lib/google/cloud/datastore/admin/version.rb +1 -1
- data/lib/google/cloud/datastore/admin.rb +25 -35
- metadata +4 -4
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: ee4922c63e63e1831dfb9b9ff650c09e7ebc2add4499e878d2d00e1f930aaee7
|
|
4
|
+
data.tar.gz: bfd514324814a5888f21f2737a91a3885d3453b287938f2f27de11d797225462
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: ce3ad0828a5cff0308bbbc1ad9edec2b1ad7079421f59189375f72ca092688cc8114fa745532610e70ce4e0f841d074e5d50facefdbde28449d43973a7f218fe
|
|
7
|
+
data.tar.gz: 2adfbdd37665e1982bc4f09f47d8a0878f8f9c959ca3b40597d10249f52e40dd26271b9b4a774bdda00b83db124ab6045549e5d74c7e9ab0ab6b8e8626fb0e9e
|
data/README.md
CHANGED
|
@@ -16,7 +16,7 @@ for this library, google-cloud-datastore-admin, to see the convenience methods f
|
|
|
16
16
|
constructing client objects. Reference documentation for the client objects
|
|
17
17
|
themselves can be found in the client library documentation for the versioned
|
|
18
18
|
client gems:
|
|
19
|
-
[google-cloud-datastore-admin-v1](https://
|
|
19
|
+
[google-cloud-datastore-admin-v1](https://cloud.google.com/ruby/docs/reference/google-cloud-datastore-admin-v1/latest).
|
|
20
20
|
|
|
21
21
|
See also the [Product Documentation](https://cloud.google.com/datastore)
|
|
22
22
|
for more usage information.
|
|
@@ -34,32 +34,6 @@ In order to use this library, you first need to go through the following steps:
|
|
|
34
34
|
1. [Enable the API.](https://console.cloud.google.com/apis/library/datastore.googleapis.com)
|
|
35
35
|
1. {file:AUTHENTICATION.md Set up authentication.}
|
|
36
36
|
|
|
37
|
-
## Enabling Logging
|
|
38
|
-
|
|
39
|
-
To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
|
|
40
|
-
The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
|
|
41
|
-
or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
|
|
42
|
-
that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
|
|
43
|
-
and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
|
|
44
|
-
|
|
45
|
-
Configuring a Ruby stdlib logger:
|
|
46
|
-
|
|
47
|
-
```ruby
|
|
48
|
-
require "logger"
|
|
49
|
-
|
|
50
|
-
module MyLogger
|
|
51
|
-
LOGGER = Logger.new $stderr, level: Logger::WARN
|
|
52
|
-
def logger
|
|
53
|
-
LOGGER
|
|
54
|
-
end
|
|
55
|
-
end
|
|
56
|
-
|
|
57
|
-
# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
|
|
58
|
-
module GRPC
|
|
59
|
-
extend MyLogger
|
|
60
|
-
end
|
|
61
|
-
```
|
|
62
|
-
|
|
63
37
|
## Supported Ruby Versions
|
|
64
38
|
|
|
65
39
|
This library is supported on Ruby 2.6+.
|
|
@@ -49,25 +49,23 @@ module Google
|
|
|
49
49
|
# Create a new client object for DatastoreAdmin.
|
|
50
50
|
#
|
|
51
51
|
# By default, this returns an instance of
|
|
52
|
-
# [Google::Cloud::Datastore::Admin::V1::DatastoreAdmin::Client](https://
|
|
52
|
+
# [Google::Cloud::Datastore::Admin::V1::DatastoreAdmin::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-datastore-admin-v1/latest/Google-Cloud-Datastore-Admin-V1-DatastoreAdmin-Client)
|
|
53
53
|
# for a gRPC client for version V1 of the API.
|
|
54
54
|
# However, you can specify a different API version by passing it in the
|
|
55
55
|
# `version` parameter. If the DatastoreAdmin service is
|
|
56
56
|
# supported by that API version, and the corresponding gem is available, the
|
|
57
57
|
# appropriate versioned client will be returned.
|
|
58
|
+
# You can also specify a different transport by passing `:rest` or `:grpc` in
|
|
59
|
+
# the `transport` parameter.
|
|
58
60
|
#
|
|
59
61
|
# ## About DatastoreAdmin
|
|
60
62
|
#
|
|
61
63
|
# Google Cloud Datastore Admin API
|
|
62
64
|
#
|
|
63
|
-
#
|
|
64
65
|
# The Datastore Admin API provides several admin services for Cloud Datastore.
|
|
65
66
|
#
|
|
66
|
-
#
|
|
67
|
-
#
|
|
68
|
-
#
|
|
69
|
-
# Project, namespace, kind, and entity as defined in the Google Cloud Datastore
|
|
70
|
-
# API.
|
|
67
|
+
# Concepts: Project, namespace, kind, and entity as defined in the Google Cloud
|
|
68
|
+
# Datastore API.
|
|
71
69
|
#
|
|
72
70
|
# Operation: An Operation represents work being performed in the background.
|
|
73
71
|
#
|
|
@@ -75,56 +73,47 @@ module Google
|
|
|
75
73
|
# specified as a combination of kinds and namespaces (either or both of which
|
|
76
74
|
# may be all).
|
|
77
75
|
#
|
|
78
|
-
#
|
|
79
|
-
# ## Services
|
|
80
|
-
#
|
|
81
|
-
# # Export/Import
|
|
76
|
+
# Export/Import Service:
|
|
82
77
|
#
|
|
83
|
-
# The Export/Import service provides the ability to copy all or a subset of
|
|
78
|
+
# - The Export/Import service provides the ability to copy all or a subset of
|
|
84
79
|
# entities to/from Google Cloud Storage.
|
|
85
|
-
#
|
|
86
|
-
# Exported data may be imported into Cloud Datastore for any Google Cloud
|
|
80
|
+
# - Exported data may be imported into Cloud Datastore for any Google Cloud
|
|
87
81
|
# Platform project. It is not restricted to the export source project. It is
|
|
88
82
|
# possible to export from one project and then import into another.
|
|
89
|
-
#
|
|
90
|
-
#
|
|
91
|
-
#
|
|
92
|
-
# Exports and imports are performed asynchronously. An Operation resource is
|
|
83
|
+
# - Exported data can also be loaded into Google BigQuery for analysis.
|
|
84
|
+
# - Exports and imports are performed asynchronously. An Operation resource is
|
|
93
85
|
# created for each export/import. The state (including any errors encountered)
|
|
94
86
|
# of the export/import may be queried via the Operation resource.
|
|
95
87
|
#
|
|
96
|
-
#
|
|
88
|
+
# Index Service:
|
|
97
89
|
#
|
|
98
|
-
# The index service manages Cloud Datastore composite indexes.
|
|
99
|
-
#
|
|
100
|
-
# Index creation and deletion are performed asynchronously.
|
|
90
|
+
# - The index service manages Cloud Datastore composite indexes.
|
|
91
|
+
# - Index creation and deletion are performed asynchronously.
|
|
101
92
|
# An Operation resource is created for each such asynchronous operation.
|
|
102
93
|
# The state of the operation (including any errors encountered)
|
|
103
94
|
# may be queried via the Operation resource.
|
|
104
95
|
#
|
|
105
|
-
#
|
|
96
|
+
# Operation Service:
|
|
106
97
|
#
|
|
107
|
-
# The Operations collection provides a record of actions performed for the
|
|
98
|
+
# - The Operations collection provides a record of actions performed for the
|
|
108
99
|
# specified project (including any operations in progress). Operations are not
|
|
109
100
|
# created directly but through calls on other collections or resources.
|
|
110
|
-
#
|
|
111
|
-
#
|
|
112
|
-
# asynchronous and the operation may continue to run for some time after the
|
|
101
|
+
# - An operation that is not yet done may be cancelled. The request to cancel
|
|
102
|
+
# is asynchronous and the operation may continue to run for some time after the
|
|
113
103
|
# request to cancel is made.
|
|
114
|
-
#
|
|
115
|
-
# An operation that is done may be deleted so that it is no longer listed as
|
|
104
|
+
# - An operation that is done may be deleted so that it is no longer listed as
|
|
116
105
|
# part of the Operation collection.
|
|
117
|
-
#
|
|
118
|
-
#
|
|
119
|
-
#
|
|
120
|
-
#
|
|
121
|
-
# but are accessed via service google.longrunning.Operations.
|
|
106
|
+
# - ListOperations returns all pending operations, but not completed
|
|
107
|
+
# operations.
|
|
108
|
+
# - Operations are created by service DatastoreAdmin, but are accessed via
|
|
109
|
+
# service google.longrunning.Operations.
|
|
122
110
|
#
|
|
123
111
|
# @param version [::String, ::Symbol] The API version to connect to. Optional.
|
|
124
112
|
# Defaults to `:v1`.
|
|
113
|
+
# @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
|
|
125
114
|
# @return [::Object] A client object for the specified version.
|
|
126
115
|
#
|
|
127
|
-
def self.datastore_admin version: :v1, &block
|
|
116
|
+
def self.datastore_admin version: :v1, transport: :grpc, &block
|
|
128
117
|
require "google/cloud/datastore/admin/#{version.to_s.downcase}"
|
|
129
118
|
|
|
130
119
|
package_name = Google::Cloud::Datastore::Admin
|
|
@@ -132,6 +121,7 @@ module Google
|
|
|
132
121
|
.select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
|
|
133
122
|
.first
|
|
134
123
|
service_module = Google::Cloud::Datastore::Admin.const_get(package_name).const_get(:DatastoreAdmin)
|
|
124
|
+
service_module = service_module.const_get(:Rest) if transport == :rest
|
|
135
125
|
service_module.const_get(:Client).new(&block)
|
|
136
126
|
end
|
|
137
127
|
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: google-cloud-datastore-admin
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.1
|
|
4
|
+
version: 0.2.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Google LLC
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2023-
|
|
11
|
+
date: 2023-08-03 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: google-cloud-core
|
|
@@ -30,7 +30,7 @@ dependencies:
|
|
|
30
30
|
requirements:
|
|
31
31
|
- - ">="
|
|
32
32
|
- !ruby/object:Gem::Version
|
|
33
|
-
version: '0.
|
|
33
|
+
version: '0.8'
|
|
34
34
|
- - "<"
|
|
35
35
|
- !ruby/object:Gem::Version
|
|
36
36
|
version: 2.a
|
|
@@ -40,7 +40,7 @@ dependencies:
|
|
|
40
40
|
requirements:
|
|
41
41
|
- - ">="
|
|
42
42
|
- !ruby/object:Gem::Version
|
|
43
|
-
version: '0.
|
|
43
|
+
version: '0.8'
|
|
44
44
|
- - "<"
|
|
45
45
|
- !ruby/object:Gem::Version
|
|
46
46
|
version: 2.a
|