feat: add default_missing_value_interpretation field; indicate KMS_SERVICE_ERROR is retryable

Google APIs · copybara-github · commit ca3d7e8f3583 · 2023-08-14T15:35:10.000-07:00
PiperOrigin-RevId: 556931084
diff --git a/google/cloud/bigquery/storage/v1/storage.proto b/google/cloud/bigquery/storage/v1/storage.proto
@@ -518,6 +518,18 @@ message AppendRowsRequest {
   // Currently, field name can only be top-level column name, can't be a struct
   // field path like 'foo.bar'.
   map<string, MissingValueInterpretation> missing_value_interpretations = 7;
+
+  // Optional. Default missing value interpretation for all columns in the
+  // table. When a value is specified on an `AppendRowsRequest`, it is applied
+  // to all requests on the connection from that point forward, until a
+  // subsequent `AppendRowsRequest` sets it to a different value.
+  // `missing_value_interpretation` can override
+  // `default_missing_value_interpretation`. For example, if you want to write
+  // `NULL` instead of using default values for some columns, you can set
+  // `default_missing_value_interpretation` to `DEFAULT_VALUE` and at the same
+  // time, set `missing_value_interpretations` to `NULL_VALUE` on those columns.
+  MissingValueInterpretation default_missing_value_interpretation = 8
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response message for `AppendRows`.
@@ -705,7 +717,8 @@ message StorageError {
     // There is an encryption error while using customer-managed encryption key.
     CMEK_ENCRYPTION_ERROR = 12;
 
-    // Key Management Service (KMS) service returned an error.
+    // Key Management Service (KMS) service returned an error, which can be
+    // retried.
     KMS_SERVICE_ERROR = 13;
 
     // Permission denied while using customer-managed encryption key.
