google-cloud-bigtable 0.4.3 → 0.5.0

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.
Files changed (23) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +5 -0
  3. data/LOGGING.md +1 -1
  4. data/OVERVIEW.md +1 -1
  5. data/lib/google/cloud/bigtable/admin.rb +2 -2
  6. data/lib/google/cloud/bigtable/admin/v2.rb +2 -2
  7. data/lib/google/cloud/bigtable/admin/v2/bigtable_instance_admin_client_config.json +40 -24
  8. data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin_client_config.json +45 -18
  9. data/lib/google/cloud/bigtable/column_family.rb +16 -10
  10. data/lib/google/cloud/bigtable/instance.rb +1 -1
  11. data/lib/google/cloud/bigtable/mutation_entry.rb +29 -14
  12. data/lib/google/cloud/bigtable/mutation_operations.rb +2 -2
  13. data/lib/google/cloud/bigtable/project.rb +1 -1
  14. data/lib/google/cloud/bigtable/row.rb +1 -1
  15. data/lib/google/cloud/bigtable/row_filter.rb +3 -2
  16. data/lib/google/cloud/bigtable/row_filter/chain_filter.rb +3 -2
  17. data/lib/google/cloud/bigtable/row_filter/interleave_filter.rb +3 -2
  18. data/lib/google/cloud/bigtable/table.rb +3 -2
  19. data/lib/google/cloud/bigtable/table/column_family_map.rb +7 -5
  20. data/lib/google/cloud/bigtable/v2.rb +2 -2
  21. data/lib/google/cloud/bigtable/v2/bigtable_client_config.json +36 -18
  22. data/lib/google/cloud/bigtable/version.rb +1 -1
  23. metadata +3 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d2c1fb609f8db01cde0db582a3b9e0ca9449d799b0ac1f846f7228588cf96aae
4
- data.tar.gz: 24f397071cd64bfb49d8b7291484220c12fcc310f947961ebe17a79035fc2821
3
+ metadata.gz: 75dda3fa2c76316a47a331878fc5b634c5bd5f471ec3c89ece5db2e8ce60c388
4
+ data.tar.gz: dfceb7dabcb83f54c3f2bf1e30d85e3ddf13e6f490260e1dd966e52c2675b05b
5
5
  SHA512:
6
- metadata.gz: 6bec388faa026a1020991fbb6f1fb183879582b67625ada410e4fbdcc940322bde9e8d0d557a6d880c023e036dee8980b1f40414fa02dbd2c7c7858aef467219
7
- data.tar.gz: a9a06cdcc075b1aa94ac74de239bf45e3c8263d77676dc3723bdc899d46ea506c49588e52f9e23f394ff644a8104df70f159313dc8e1a162fd52494e73c785ad
6
+ metadata.gz: 88626715dc50760d929db8819cdf6333a7faffe67153222a81dcd2d941ced9cc471912f33ed74fa04a0c629f4d351386f9ae6ca098f4d083eb24100b5120b82d
7
+ data.tar.gz: 3c5c577ae655453c155fab31735312933c834984b2d2091a7950fddbec9532f71b8d395d41a3c768d4ed6bec016f07f5384c11ac547075e1cfb67ed0abaf7b51
data/CHANGELOG.md CHANGED
@@ -1,5 +1,10 @@
1
1
  # Release History
2
2
 
3
+ ### 0.5.0 / 2019-08-05
4
+
5
+ * Accept nil gc_rule arguments for column_family create/update
6
+ * Update documentation
7
+
3
8
  ### 0.4.3 / 2019-07-12
4
9
 
5
10
  * Update #to_hash to #to_h for compatibility with google-protobuf >= 3.9.0
data/LOGGING.md CHANGED
@@ -5,7 +5,7 @@ To enable logging for this library, set the logger for the underlying
5
5
  that you set may be a Ruby stdlib
6
6
  [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as
7
7
  shown below, or a
8
- [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/Google/Cloud/Logging/Logger)
8
+ [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
9
9
  that will write logs to [Stackdriver
10
10
  Logging](https://cloud.google.com/logging/). See
11
11
  [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
data/OVERVIEW.md CHANGED
@@ -14,7 +14,7 @@ steps:
14
14
  1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
15
15
  2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
16
16
  3. [Enable the Cloud Bigtable API.](https://console.cloud.google.com/apis/library/bigtable.googleapis.com)
17
- 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/docs/google-cloud/latest/file.AUTHENTICATION)
17
+ 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-bigtable/latest/file.AUTHENTICATION.html)
18
18
 
19
19
  ### Next Steps
20
20
  - Read the [Cloud Bigtable API Product documentation][Product Documentation]
data/lib/google/cloud/bigtable/admin.rb CHANGED
@@ -35,7 +35,7 @@ module Google
35
35
  # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
36
36
  # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
37
37
  # 3. [Enable the Cloud Bigtable Admin API.](https://console.cloud.google.com/apis/library/bigtableadmin.googleapis.com)
38
- # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
38
+ # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-bigtable/latest/file.AUTHENTICATION.html)
39
39
  #
40
40
  # ### Installation
41
41
  # ```
@@ -54,7 +54,7 @@ module Google
54
54
  #
55
55
  # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
56
56
  # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
57
- # or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
57
+ # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
58
58
  # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
59
59
  # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
60
60
  #
data/lib/google/cloud/bigtable/admin/v2.rb CHANGED
@@ -38,7 +38,7 @@ module Google
38
38
  # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
39
39
  # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
40
40
  # 3. [Enable the Cloud Bigtable Admin API.](https://console.cloud.google.com/apis/library/bigtableadmin.googleapis.com)
41
- # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
41
+ # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-bigtable/latest/file.AUTHENTICATION.html)
42
42
  #
43
43
  # ### Installation
44
44
  # ```
@@ -57,7 +57,7 @@ module Google
57
57
  #
58
58
  # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
59
59
  # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
60
- # or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
60
+ # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
61
61
  # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
62
62
  # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
63
63
  #
data/lib/google/cloud/bigtable/admin/v2/bigtable_instance_admin_client_config.json CHANGED
@@ -6,116 +6,132 @@
6
6
  "DEADLINE_EXCEEDED",
7
7
  "UNAVAILABLE"
8
8
  ],
9
- "non_idempotent": [
10
- "UNAVAILABLE"
11
- ]
9
+ "non_idempotent": []
12
10
  },
13
11
  "retry_params": {
14
- "default": {
15
- "initial_retry_delay_millis": 5,
12
+ "idempotent_params": {
13
+ "initial_retry_delay_millis": 1000,
16
14
  "retry_delay_multiplier": 2.0,
17
15
  "max_retry_delay_millis": 60000,
18
16
  "initial_rpc_timeout_millis": 60000,
19
17
  "rpc_timeout_multiplier": 1.0,
20
18
  "max_rpc_timeout_millis": 60000,
21
19
  "total_timeout_millis": 600000
20
+ },
21
+ "non_idempotent_params": {
22
+ "initial_retry_delay_millis": 0,
23
+ "retry_delay_multiplier": 1.0,
24
+ "max_retry_delay_millis": 0,
25
+ "initial_rpc_timeout_millis": 60000,
26
+ "rpc_timeout_multiplier": 1.0,
27
+ "max_rpc_timeout_millis": 60000,
28
+ "total_timeout_millis": 60000
29
+ },
30
+ "non_idempotent_heavy_params": {
31
+ "initial_retry_delay_millis": 0,
32
+ "retry_delay_multiplier": 1.0,
33
+ "max_retry_delay_millis": 0,
34
+ "initial_rpc_timeout_millis": 300000,
35
+ "rpc_timeout_multiplier": 1.0,
36
+ "max_rpc_timeout_millis": 300000,
37
+ "total_timeout_millis": 300000
22
38
  }
23
39
  },
24
40
  "methods": {
25
41
  "CreateInstance": {
26
42
  "timeout_millis": 60000,
27
43
  "retry_codes_name": "non_idempotent",
28
- "retry_params_name": "default"
44
+ "retry_params_name": "non_idempotent_heavy_params"
29
45
  },
30
46
  "GetInstance": {
31
47
  "timeout_millis": 60000,
32
48
  "retry_codes_name": "idempotent",
33
- "retry_params_name": "default"
49
+ "retry_params_name": "idempotent_params"
34
50
  },
35
51
  "ListInstances": {
36
52
  "timeout_millis": 60000,
37
53
  "retry_codes_name": "idempotent",
38
- "retry_params_name": "default"
54
+ "retry_params_name": "idempotent_params"
39
55
  },
40
56
  "UpdateInstance": {
41
57
  "timeout_millis": 60000,
42
58
  "retry_codes_name": "idempotent",
43
- "retry_params_name": "default"
59
+ "retry_params_name": "idempotent_params"
44
60
  },
45
61
  "PartialUpdateInstance": {
46
62
  "timeout_millis": 60000,
47
63
  "retry_codes_name": "idempotent",
48
- "retry_params_name": "default"
64
+ "retry_params_name": "idempotent_params"
49
65
  },
50
66
  "DeleteInstance": {
51
67
  "timeout_millis": 60000,
52
68
  "retry_codes_name": "non_idempotent",
53
- "retry_params_name": "default"
69
+ "retry_params_name": "non_idempotent_params"
54
70
  },
55
71
  "CreateCluster": {
56
72
  "timeout_millis": 60000,
57
73
  "retry_codes_name": "non_idempotent",
58
- "retry_params_name": "default"
74
+ "retry_params_name": "non_idempotent_params"
59
75
  },
60
76
  "GetCluster": {
61
77
  "timeout_millis": 60000,
62
78
  "retry_codes_name": "idempotent",
63
- "retry_params_name": "default"
79
+ "retry_params_name": "idempotent_params"
64
80
  },
65
81
  "ListClusters": {
66
82
  "timeout_millis": 60000,
67
83
  "retry_codes_name": "idempotent",
68
- "retry_params_name": "default"
84
+ "retry_params_name": "idempotent_params"
69
85
  },
70
86
  "UpdateCluster": {
71
87
  "timeout_millis": 60000,
72
88
  "retry_codes_name": "idempotent",
73
- "retry_params_name": "default"
89
+ "retry_params_name": "idempotent_params"
74
90
  },
75
91
  "DeleteCluster": {
76
92
  "timeout_millis": 60000,
77
93
  "retry_codes_name": "non_idempotent",
78
- "retry_params_name": "default"
94
+ "retry_params_name": "non_idempotent_params"
79
95
  },
80
96
  "CreateAppProfile": {
81
97
  "timeout_millis": 60000,
82
98
  "retry_codes_name": "non_idempotent",
83
- "retry_params_name": "default"
99
+ "retry_params_name": "non_idempotent_params"
84
100
  },
85
101
  "GetAppProfile": {
86
102
  "timeout_millis": 60000,
87
103
  "retry_codes_name": "idempotent",
88
- "retry_params_name": "default"
104
+ "retry_params_name": "idempotent_params"
89
105
  },
90
106
  "ListAppProfiles": {
91
107
  "timeout_millis": 60000,
92
108
  "retry_codes_name": "idempotent",
93
- "retry_params_name": "default"
109
+ "retry_params_name": "idempotent_params"
94
110
  },
95
111
  "UpdateAppProfile": {
96
112
  "timeout_millis": 60000,
97
113
  "retry_codes_name": "idempotent",
98
- "retry_params_name": "default"
114
+ "retry_params_name": "idempotent_params"
99
115
  },
100
116
  "DeleteAppProfile": {
101
117
  "timeout_millis": 60000,
102
118
  "retry_codes_name": "non_idempotent",
103
- "retry_params_name": "default"
119
+ "retry_params_name": "non_idempotent_params"
104
120
  },
105
121
  "GetIamPolicy": {
106
122
  "timeout_millis": 60000,
107
123
  "retry_codes_name": "idempotent",
108
- "retry_params_name": "default"
124
+ "retry_params_name": "idempotent_params"
109
125
  },
110
126
  "SetIamPolicy": {
111
127
  "timeout_millis": 60000,
112
128
  "retry_codes_name": "non_idempotent",
113
- "retry_params_name": "default"
129
+ "retry_params_name": "non_idempotent_params"
114
130
  },
115
131
  "TestIamPermissions": {
116
132
  "timeout_millis": 60000,
117
133
  "retry_codes_name": "idempotent",
118
- "retry_params_name": "default"
134
+ "retry_params_name": "idempotent_params"
119
135
  }
120
136
  }
121
137
  }
data/lib/google/cloud/bigtable/admin/v2/bigtable_table_admin_client_config.json CHANGED
@@ -9,81 +9,108 @@
9
9
  "non_idempotent": []
10
10
  },
11
11
  "retry_params": {
12
- "default": {
13
- "initial_retry_delay_millis": 100,
14
- "retry_delay_multiplier": 1.3,
12
+ "idempotent_params": {
13
+ "initial_retry_delay_millis": 1000,
14
+ "retry_delay_multiplier": 2.0,
15
15
  "max_retry_delay_millis": 60000,
16
- "initial_rpc_timeout_millis": 20000,
16
+ "initial_rpc_timeout_millis": 60000,
17
17
  "rpc_timeout_multiplier": 1.0,
18
- "max_rpc_timeout_millis": 20000,
18
+ "max_rpc_timeout_millis": 60000,
19
19
  "total_timeout_millis": 600000
20
+ },
21
+ "non_idempotent_params": {
22
+ "initial_retry_delay_millis": 0,
23
+ "retry_delay_multiplier": 1.0,
24
+ "max_retry_delay_millis": 0,
25
+ "initial_rpc_timeout_millis": 60000,
26
+ "rpc_timeout_multiplier": 1.0,
27
+ "max_rpc_timeout_millis": 60000,
28
+ "total_timeout_millis": 60000
29
+ },
30
+ "non_idempotent_heavy_params": {
31
+ "initial_retry_delay_millis": 0,
32
+ "retry_delay_multiplier": 1.0,
33
+ "max_retry_delay_millis": 0,
34
+ "initial_rpc_timeout_millis": 300000,
35
+ "rpc_timeout_multiplier": 1.0,
36
+ "max_rpc_timeout_millis": 300000,
37
+ "total_timeout_millis": 300000
38
+ },
39
+ "drop_row_range_params": {
40
+ "initial_retry_delay_millis": 0,
41
+ "retry_delay_multiplier": 1.0,
42
+ "max_retry_delay_millis": 0,
43
+ "initial_rpc_timeout_millis": 3600000,
44
+ "rpc_timeout_multiplier": 1.0,
45
+ "max_rpc_timeout_millis": 3600000,
46
+ "total_timeout_millis": 3600000
20
47
  }
21
48
  },
22
49
  "methods": {
23
50
  "CreateTable": {
24
51
  "timeout_millis": 130000,
25
52
  "retry_codes_name": "non_idempotent",
26
- "retry_params_name": "default"
53
+ "retry_params_name": "non_idempotent_heavy_params"
27
54
  },
28
55
  "CreateTableFromSnapshot": {
29
56
  "timeout_millis": 60000,
30
57
  "retry_codes_name": "non_idempotent",
31
- "retry_params_name": "default"
58
+ "retry_params_name": "non_idempotent_params"
32
59
  },
33
60
  "ListTables": {
34
61
  "timeout_millis": 60000,
35
62
  "retry_codes_name": "idempotent",
36
- "retry_params_name": "default"
63
+ "retry_params_name": "idempotent_params"
37
64
  },
38
65
  "GetTable": {
39
66
  "timeout_millis": 60000,
40
67
  "retry_codes_name": "idempotent",
41
- "retry_params_name": "default"
68
+ "retry_params_name": "idempotent_params"
42
69
  },
43
70
  "DeleteTable": {
44
71
  "timeout_millis": 60000,
45
72
  "retry_codes_name": "non_idempotent",
46
- "retry_params_name": "default"
73
+ "retry_params_name": "non_idempotent_params"
47
74
  },
48
75
  "ModifyColumnFamilies": {
49
76
  "timeout_millis": 60000,
50
77
  "retry_codes_name": "non_idempotent",
51
- "retry_params_name": "default"
78
+ "retry_params_name": "non_idempotent_heavy_params"
52
79
  },
53
80
  "DropRowRange": {
54
81
  "timeout_millis": 900000,
55
82
  "retry_codes_name": "non_idempotent",
56
- "retry_params_name": "default"
83
+ "retry_params_name": "drop_row_range_params"
57
84
  },
58
85
  "GenerateConsistencyToken": {
59
86
  "timeout_millis": 60000,
60
87
  "retry_codes_name": "idempotent",
61
- "retry_params_name": "default"
88
+ "retry_params_name": "idempotent_params"
62
89
  },
63
90
  "CheckConsistency": {
64
91
  "timeout_millis": 60000,
65
92
  "retry_codes_name": "idempotent",
66
- "retry_params_name": "default"
93
+ "retry_params_name": "idempotent_params"
67
94
  },
68
95
  "SnapshotTable": {
69
96
  "timeout_millis": 60000,
70
97
  "retry_codes_name": "non_idempotent",
71
- "retry_params_name": "default"
98
+ "retry_params_name": "non_idempotent_params"
72
99
  },
73
100
  "GetSnapshot": {
74
101
  "timeout_millis": 60000,
75
102
  "retry_codes_name": "idempotent",
76
- "retry_params_name": "default"
103
+ "retry_params_name": "idempotent_params"
77
104
  },
78
105
  "ListSnapshots": {
79
106
  "timeout_millis": 60000,
80
107
  "retry_codes_name": "idempotent",
81
- "retry_params_name": "default"
108
+ "retry_params_name": "idempotent_params"
82
109
  },
83
110
  "DeleteSnapshot": {
84
111
  "timeout_millis": 60000,
85
112
  "retry_codes_name": "non_idempotent",
86
- "retry_params_name": "default"
113
+ "retry_params_name": "non_idempotent_params"
87
114
  }
88
115
  }
89
116
  }
data/lib/google/cloud/bigtable/column_family.rb CHANGED
@@ -34,7 +34,7 @@ module Google
34
34
  #
35
35
  # # Create
36
36
  # gc_rule = Google::Cloud::Bigtable::GcRule.max_versions(5)
37
- # column_family = table.column_families.create("cf1", gc_rule: gc_rule)
37
+ # column_family = table.column_families.add("cf1", gc_rule)
38
38
  #
39
39
  # # Update
40
40
  # column_family = table.column_families.find_by_name("cf2")
@@ -74,10 +74,11 @@ module Google
74
74
 
75
75
  # Set Column Family garbage collection rules
76
76
  #
77
- # @param rule [Google::Cloud::Bigtable::GcRule]
77
+ # @param rule [Google::Cloud::Bigtable::GcRule, nil] the new rule, or
78
+ # `nil` for the service default value.
78
79
  #
79
80
  def gc_rule= rule
80
- @grpc.gc_rule = rule.to_grpc
81
+ @grpc.gc_rule = rule.nil? ? nil : rule.to_grpc
81
82
  end
82
83
 
83
84
  # Get garbage collection rule
@@ -151,7 +152,9 @@ module Google
151
152
  # Create gPRC instance to create column family modification
152
153
  #
153
154
  # @param name [String] Column family name
154
- # @param gc_rule [Google::Cloud::Bigtable::GcRule] GC Rule
155
+ # @param gc_rule [Google::Cloud::Bigtable::GcRule] The garbage
156
+ # collection rule to be used for the column family. Optional. The
157
+ # service default value will be used when not specified.
155
158
  # @return [Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification]
156
159
  #
157
160
  # @example
@@ -168,7 +171,9 @@ module Google
168
171
  # Create update column family modification gPRC instance
169
172
  #
170
173
  # @param name [String] Column family name
171
- # @param gc_rule [Google::Cloud::Bigtable::GcRule] GC Rule
174
+ # @param gc_rule [Google::Cloud::Bigtable::GcRule] The garbage
175
+ # collection rule to be used for the column family. Optional. The
176
+ # service default value will be used when not specified.
172
177
  # @return [Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification]
173
178
  #
174
179
  # @example
@@ -227,8 +232,9 @@ module Google
227
232
  # @param type [Symbol] Type of modification.
228
233
  # Valid values are `:create`, `:update`, `drop`
229
234
  # @param family_name [String] Column family name
230
- # @param gc_rule [Google::Cloud::Bigtable::GcRule]
231
- # Required for only create and update modification type.
235
+ # @param gc_rule [Google::Cloud::Bigtable::GcRule] The garbage
236
+ # collection rule to be used for the column family. Optional. The
237
+ # service default value will be used when not specified.
232
238
  # @return [Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest::Modification]
233
239
  #
234
240
  def self.column_modification_grpc type, family_name, gc_rule = nil
@@ -237,9 +243,9 @@ module Google
237
243
  attrs[type] = if type == :drop
238
244
  true
239
245
  else
240
- Google::Bigtable::Admin::V2::ColumnFamily.new(
241
- gc_rule: gc_rule.to_grpc
242
- )
246
+ cf = Google::Bigtable::Admin::V2::ColumnFamily.new
247
+ cf.gc_rule = gc_rule.to_grpc if gc_rule
248
+ cf
243
249
  end
244
250
 
245
251
  Google::Bigtable::Admin::V2::ModifyColumnFamiliesRequest:: \
data/lib/google/cloud/bigtable/instance.rb CHANGED
@@ -486,7 +486,7 @@ module Google
486
486
  # "cf-1",
487
487
  # "field-1",
488
488
  # "XYZ",
489
- # timestamp: Time.now.to_i * 1000 # Time stamp in milli seconds.
489
+ # timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
490
490
  # ).delete_cells("cf2", "field02")
491
491
  #
492
492
  # table.mutate_row(entry)
data/lib/google/cloud/bigtable/mutation_entry.rb CHANGED
@@ -31,13 +31,14 @@ module Google
31
31
  #
32
32
  # @example
33
33
  # entry = Google::Cloud::Bigtable::MutationEntry.new("user-1")
34
+ # timestamp_micros = (Time.now.to_f * 1000000).round(-3)
34
35
  # entry.set_cell(
35
- # "cf1", "fiel01", "XYZ", timestamp: Time.now.to_i * 1000
36
+ # "cf1", "fiel01", "XYZ", timestamp: timestamp_micros
36
37
  # ).delete_cells(
37
38
  # "cf2",
38
39
  # "field02",
39
- # timestamp_from: (Time.now.to_i - 1800) * 1000,
40
- # timestamp_to: (Time.now.to_i * 1000)
40
+ # timestamp_from: timestamp_micros - 5000000,
41
+ # timestamp_to: timestamp_micros
41
42
  # ).delete_from_family("cf3").delete_from_row
42
43
  #
43
44
  # @example Using table
@@ -47,8 +48,9 @@ module Google
47
48
  # table = bigtable.table("my-instance", "my-table")
48
49
  #
49
50
  # entry = table.new_mutation_entry("user-1")
51
+ # timestamp_micros = (Time.now.to_f * 1000000).round(-3)
50
52
  # entry.set_cell(
51
- # "cf1", "fiel01", "XYZ", timestamp: Time.now.to_i * 1000
53
+ # "cf1", "fiel01", "XYZ", timestamp: timestamp_micros
52
54
  # )
53
55
  #
54
56
  class MutationEntry
@@ -79,12 +81,15 @@ module Google
79
81
  # Can be any byte string, including an empty string.
80
82
  # @param value [String, Integer] Cell value data.
81
83
  # The value to be written into the specified cell.
82
- # @param timestamp [Time, Integer] Timestamp value.
84
+ # @param timestamp [Integer] Timestamp value in microseconds.
83
85
  # The timestamp of the cell into which new data should be written.
84
86
  # Use -1 for current Bigtable server time.
85
87
  # Otherwise, the client should set this value itself, noting that the
86
88
  # default value is a timestamp of zero if the field is left unspecified.
87
- # Values must match the granularity of the table (micros or millis, for example).
89
+ # Values are in microseconds but must match the granularity of the
90
+ # table. Therefore, if {Table#granularity} is `MILLIS` (the default),
91
+ # the given value must be a multiple of 1000 (millisecond
92
+ # granularity). For example: `1564257960168000`.
88
93
  # @return [MutationEntry] `self` object of entry for chaining.
89
94
  #
90
95
  # @example
@@ -97,7 +102,7 @@ module Google
97
102
  # "cf-1",
98
103
  # "field-1",
99
104
  # "XYZ",
100
- # timestamp: Time.now.to_i * 1000 # Time stamp in millis seconds.
105
+ # timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
101
106
  # )
102
107
  #
103
108
  def set_cell family, qualifier, value, timestamp: nil
@@ -128,10 +133,18 @@ module Google
128
133
  # @param qualifier [String] Column qualifier name.
129
134
  # The qualifier of the column from which cells should be deleted.
130
135
  # Can be any byte string, including an empty string.
131
- # @param timestamp_from [Integer] Timestamp lower boundary. Optional.
132
- # The range of timestamps from which cells should be deleted.
133
- # @param timestamp_to [Integer] Timestamp upper boundary. Optional.
134
- # The range of timestamps from which cells should be deleted.
136
+ # @param timestamp_from [Integer] Timestamp lower boundary in
137
+ # microseconds. Optional. Begins the range of timestamps from which
138
+ # cells should be deleted. Values are in microseconds but must match
139
+ # the granularity of the table. Therefore, if {Table#granularity} is
140
+ # `MILLIS` (the default), the given value must be a multiple of 1000
141
+ # (millisecond granularity). For example: `1564257960168000`.
142
+ # @param timestamp_to [Integer] Timestamp upper boundary in
143
+ # microseconds. Optional. Ends the range of timestamps from which
144
+ # cells should be deleted. Values are in microseconds but must match
145
+ # the granularity of the table. Therefore, if {Table#granularity} is
146
+ # `MILLIS` (the default), the given value must be a multiple of 1000
147
+ # (millisecond granularity). For example: `1564257960168000`.
135
148
  # @return [MutationEntry] `self` object of entry for chaining.
136
149
  #
137
150
  # @example Without timestamp range
@@ -140,18 +153,20 @@ module Google
140
153
  #
141
154
  # @example With timestamp range
142
155
  # entry = Google::Cloud::Bigtable::MutationEntry.new("user-1")
156
+ # timestamp_micros = (Time.now.to_f * 1000000).round(-3)
143
157
  # entry.delete_cells(
144
158
  # "cf1",
145
159
  # "field-1",
146
- # timestamp_from: (Time.now.to_i - 1800) * 1000,
147
- # timestamp_to: (Time.now.to_i * 1000)
160
+ # timestamp_from: timestamp_micros - 5000000,
161
+ # timestamp_to: timestamp_micros
148
162
  # )
149
163
  # @example With timestamp range with lower boundary only
150
164
  # entry = Google::Cloud::Bigtable::MutationEntry.new("user-1")
165
+ # timestamp_micros = (Time.now.to_f * 1000000).round(-3)
151
166
  # entry.delete_cells(
152
167
  # "cf1",
153
168
  # "field-1",
154
- # timestamp_from: (Time.now.to_i - 1800) * 1000
169
+ # timestamp_from: timestamp_micros - 5000000
155
170
  # )
156
171
  #
157
172
  def delete_cells \
data/lib/google/cloud/bigtable/mutation_operations.rb CHANGED
@@ -67,7 +67,7 @@ module Google
67
67
  # "cf-1",
68
68
  # "field-1",
69
69
  # "XYZ",
70
- # timestamp: Time.now.to_i * 1000 # Time stamp in milli seconds.
70
+ # timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
71
71
  # ).delete_cells("cf2", "field02")
72
72
  #
73
73
  # table.mutate_row(entry)
@@ -216,7 +216,7 @@ module Google
216
216
  # "cf-1",
217
217
  # "field-1",
218
218
  # "XYZ",
219
- # timestamp: Time.now.to_i * 1000 # Time stamp in micro seconds.
219
+ # timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
220
220
  # ).delete_cells("cf2", "field02")
221
221
  #
222
222
  # otherwise_mutations = Google::Cloud::Bigtable::MutationEntry.new
data/lib/google/cloud/bigtable/project.rb CHANGED
@@ -360,7 +360,7 @@ module Google
360
360
  # "cf-1",
361
361
  # "field-1",
362
362
  # "XYZ",
363
- # timestamp: Time.now.to_i * 1000 # Timestamp in milliseconds.
363
+ # timestamp: (Time.now.to_f * 1000000).round(-3) # microseconds
364
364
  # ).delete_cells("cf2", "field02")
365
365
  #
366
366
  # table.mutate_row(entry)
data/lib/google/cloud/bigtable/row.rb CHANGED
@@ -32,7 +32,7 @@ module Google
32
32
  #
33
33
  # @param family [String] Column family name
34
34
  # @param qualifier [String] Column cell qualifier name
35
- # @param timestamp [Integer] Timestamp in micro seconds
35
+ # @param timestamp [Integer] Timestamp in microseconds
36
36
  # @param value [String] Cell value
37
37
  # @param labels [Array<String>] List of label array
38
38
 
data/lib/google/cloud/bigtable/row_filter.rb CHANGED
@@ -527,8 +527,9 @@ module Google
527
527
  #
528
528
  # @example
529
529
  #
530
- # from = (Time.now - 300).to_i * 1000
531
- # to = Time.now.to_f * 1000
530
+ # timestamp_micros = (Time.now.to_f * 1000000).round(-3)
531
+ # from = timestamp_micros - 300000000
532
+ # to = timestamp_micros
532
533
  #
533
534
  # filter = Google::Cloud::Bigtable::RowFilter.timestamp_range(from: from, to: to)
534
535
  #
data/lib/google/cloud/bigtable/row_filter/chain_filter.rb CHANGED
@@ -433,8 +433,9 @@ module Google
433
433
  #
434
434
  # @example
435
435
  #
436
- # from = (Time.now - 300).to_i * 1000 # 300 seconds ago
437
- # to = Time.now.to_f * 1000
436
+ # timestamp_micros = (Time.now.to_f * 1000000).round(-3)
437
+ # from = timestamp_micros - 300000000
438
+ # to = timestamp_micros
438
439
  #
439
440
  # filter = Google::Cloud::Bigtable::RowFilter.chain.timestamp_range(from: from, to: to)
440
441
  #
data/lib/google/cloud/bigtable/row_filter/interleave_filter.rb CHANGED
@@ -465,8 +465,9 @@ module Google
465
465
  #
466
466
  # @example
467
467
  #
468
- # from = (Time.now - 300).to_f * 1000
469
- # to = Time.now.to_f * 1000
468
+ # timestamp_micros = (Time.now.to_f * 1000000).round(-3)
469
+ # from = timestamp_micros - 300000000
470
+ # to = timestamp_micros
470
471
  #
471
472
  # filter = Google::Cloud::Bigtable::RowFilter.interleave.timestamp_range(from: from, to: to)
472
473
  #
data/lib/google/cloud/bigtable/table.rb CHANGED
@@ -238,8 +238,9 @@ module Google
238
238
  # update, or delete operations.
239
239
  #
240
240
  # @param name [String] Name of the column family
241
- # @param gc_rule [Google::Cloud::Bigtable::GcRule] Optional.
242
- # Required for create and update operations.
241
+ # @param gc_rule [Google::Cloud::Bigtable::GcRule] The garbage
242
+ # collection rule to be used for the column family. Optional. The
243
+ # service default value will be used when not specified.
243
244
  #
244
245
  # @example Create column family
245
246
  # require "google/cloud/bigtable"
data/lib/google/cloud/bigtable/table/column_family_map.rb CHANGED
@@ -37,7 +37,9 @@ module Google
37
37
  # Adds a column family.
38
38
  #
39
39
  # @param name [String] Column family name
40
- # @param gc_rule [Google::Bigtable::GcRule] GC Rule
40
+ # @param gc_rule [Google::Cloud::Bigtable::GcRule] The garbage
41
+ # collection rule to be used for the column family. Optional. The
42
+ # service default value will be used when not specified.
41
43
  # @example
42
44
  # column_families = Google::Cloud::Bigtable::Instance::ColumnFamilyMap.new
43
45
  #
@@ -47,10 +49,10 @@ module Google
47
49
  # gc_rule = Google::Cloud::Bigtable::GcRule.max_age(1800)
48
50
  # column_families.add('cf2', gc_rule)
49
51
 
50
- def add name, gc_rule
51
- self[name] = Google::Bigtable::Admin::V2::ColumnFamily.new(
52
- gc_rule: gc_rule.to_grpc
53
- )
52
+ def add name, gc_rule = nil
53
+ cf = Google::Bigtable::Admin::V2::ColumnFamily.new
54
+ cf.gc_rule = gc_rule.to_grpc if gc_rule
55
+ self[name] = cf
54
56
  end
55
57
 
56
58
  # Removes a column family from the map.
data/lib/google/cloud/bigtable/v2.rb CHANGED
@@ -35,7 +35,7 @@ module Google
35
35
  # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
36
36
  # 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
37
37
  # 3. [Enable the Cloud Bigtable API.](https://console.cloud.google.com/apis/library/bigtable.googleapis.com)
38
- # 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
38
+ # 4. [Setup Authentication.](https://googleapis.dev/ruby/google-cloud-bigtable/latest/file.AUTHENTICATION.html)
39
39
  #
40
40
  # ### Installation
41
41
  # ```
@@ -54,7 +54,7 @@ module Google
54
54
  #
55
55
  # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
56
56
  # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
57
- # or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
57
+ # or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
58
58
  # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
59
59
  # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
60
60
  #
data/lib/google/cloud/bigtable/v2/bigtable_client_config.json CHANGED
@@ -9,55 +9,73 @@
9
9
  "non_idempotent": []
10
10
  },
11
11
  "retry_params": {
12
- "default": {
13
- "initial_retry_delay_millis": 100,
14
- "retry_delay_multiplier": 1.3,
12
+ "idempotent_params": {
13
+ "initial_retry_delay_millis": 10,
14
+ "retry_delay_multiplier": 2.0,
15
15
  "max_retry_delay_millis": 60000,
16
16
  "initial_rpc_timeout_millis": 20000,
17
17
  "rpc_timeout_multiplier": 1.0,
18
18
  "max_rpc_timeout_millis": 20000,
19
19
  "total_timeout_millis": 600000
20
20
  },
21
- "streaming": {
22
- "initial_retry_delay_millis": 100,
23
- "retry_delay_multiplier": 1.3,
21
+ "non_idempotent_params": {
22
+ "initial_retry_delay_millis": 10,
23
+ "retry_delay_multiplier": 2.0,
24
24
  "max_retry_delay_millis": 60000,
25
25
  "initial_rpc_timeout_millis": 20000,
26
26
  "rpc_timeout_multiplier": 1.0,
27
27
  "max_rpc_timeout_millis": 20000,
28
- "total_timeout_millis": 3600000
28
+ "total_timeout_millis": 20000
29
+ },
30
+ "read_rows_params": {
31
+ "initial_retry_delay_millis": 10,
32
+ "retry_delay_multiplier": 2.0,
33
+ "max_retry_delay_millis": 60000,
34
+ "initial_rpc_timeout_millis": 300000,
35
+ "rpc_timeout_multiplier": 1.0,
36
+ "max_rpc_timeout_millis": 300000,
37
+ "total_timeout_millis": 43200000
38
+ },
39
+ "mutate_rows_params": {
40
+ "initial_retry_delay_millis": 10,
41
+ "retry_delay_multiplier": 2.0,
42
+ "max_retry_delay_millis": 60000,
43
+ "initial_rpc_timeout_millis": 60000,
44
+ "rpc_timeout_multiplier": 1.0,
45
+ "max_rpc_timeout_millis": 60000,
46
+ "total_timeout_millis": 600000
29
47
  }
30
48
  },
31
49
  "methods": {
32
50
  "ReadRows": {
33
- "timeout_millis": 3600000,
51
+ "timeout_millis": 43200000,
34
52
  "retry_codes_name": "idempotent",
35
- "retry_params_name": "streaming"
53
+ "retry_params_name": "read_rows_params"
36
54
  },
37
55
  "SampleRowKeys": {
38
- "timeout_millis": 60000,
56
+ "timeout_millis": 20000,
39
57
  "retry_codes_name": "idempotent",
40
- "retry_params_name": "default"
58
+ "retry_params_name": "idempotent_params"
41
59
  },
42
60
  "MutateRow": {
43
- "timeout_millis": 60000,
61
+ "timeout_millis": 20000,
44
62
  "retry_codes_name": "idempotent",
45
- "retry_params_name": "default"
63
+ "retry_params_name": "idempotent_params"
46
64
  },
47
65
  "MutateRows": {
48
66
  "timeout_millis": 60000,
49
67
  "retry_codes_name": "idempotent",
50
- "retry_params_name": "default"
68
+ "retry_params_name": "mutate_rows_params"
51
69
  },
52
70
  "CheckAndMutateRow": {
53
- "timeout_millis": 60000,
71
+ "timeout_millis": 20000,
54
72
  "retry_codes_name": "non_idempotent",
55
- "retry_params_name": "default"
73
+ "retry_params_name": "non_idempotent_params"
56
74
  },
57
75
  "ReadModifyWriteRow": {
58
- "timeout_millis": 60000,
76
+ "timeout_millis": 20000,
59
77
  "retry_codes_name": "non_idempotent",
60
- "retry_params_name": "default"
78
+ "retry_params_name": "non_idempotent_params"
61
79
  }
62
80
  }
63
81
  }
data/lib/google/cloud/bigtable/version.rb CHANGED
@@ -16,7 +16,7 @@
16
16
  module Google
17
17
  module Cloud
18
18
  module Bigtable
19
- VERSION = "0.4.3".freeze
19
+ VERSION = "0.5.0".freeze
20
20
  end
21
21
  end
22
22
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigtable
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.3
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2019-07-12 00:00:00.000000000 Z
11
+ date: 2019-08-05 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-gax
@@ -284,7 +284,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
284
284
  - !ruby/object:Gem::Version
285
285
  version: '0'
286
286
  requirements: []
287
- rubygems_version: 3.0.3
287
+ rubygems_version: 3.0.4
288
288
  signing_key:
289
289
  specification_version: 4
290
290
  summary: API Client library for Cloud Bigtable API