feat: add proto annotation for non-ascii field mapping

Google APIs · copybara-github · commit 46cfc4c8d90c · 2022-09-12T12:26:44.000-07:00
PiperOrigin-RevId: 473815595
diff --git a/google/cloud/bigquery/storage/v1/BUILD.bazel b/google/cloud/bigquery/storage/v1/BUILD.bazel
@@ -10,6 +10,7 @@ load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 proto_library(
     name = "storage_proto",
     srcs = [
+        "annotations.proto",
         "arrow.proto",
         "avro.proto",
         "protobuf.proto",
diff --git a/google/cloud/bigquery/storage/v1/annotations.proto b/google/cloud/bigquery/storage/v1/annotations.proto
@@ -0,0 +1,28 @@
+syntax = "proto3";
+
+package google.cloud.bigquery.storage.v1;
+
+import "google/protobuf/descriptor.proto";
+
+option csharp_namespace = "Google.Cloud.BigQuery.Storage.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1;storage";
+option java_package = "com.google.cloud.bigquery.storage.v1";
+option java_multiple_files = true;
+option java_outer_classname = "AnnotationsProto";
+option php_namespace = "Google\\Cloud\\BigQuery\\Storage\\V1";
+
+extend google.protobuf.FieldOptions {
+  // Setting the column_name extension allows users to reference
+  // bigquery column independently of the field name in the protocol buffer
+  // message.
+  //
+  // The intended use of this annotation is to reference a destination column
+  // named using characters unavailable for protobuf field names (e.g. unicode
+  // characters).
+  //
+  // More details about BigQuery naming limitations can be found here:
+  // https://cloud.google.com/bigquery/docs/schemas#column_names
+  //
+  // This extension is currently experimental.
+  optional string column_name = 454943157;
+}
