2018-06-19 15:30:26 +02:00
|
|
|
// Copyright 2016 Google LLC
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
// you may not use this file except in compliance with the License.
|
|
|
|
// You may obtain a copy of the License at
|
|
|
|
//
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
// See the License for the specific language governing permissions and
|
|
|
|
// limitations under the License.
|
|
|
|
|
|
|
|
package bigquery
|
|
|
|
|
|
|
|
import (
|
|
|
|
"encoding/base64"
|
|
|
|
"errors"
|
|
|
|
"fmt"
|
|
|
|
"math/big"
|
|
|
|
"reflect"
|
|
|
|
"regexp"
|
|
|
|
"time"
|
|
|
|
|
|
|
|
"cloud.google.com/go/civil"
|
|
|
|
"cloud.google.com/go/internal/fields"
|
|
|
|
bq "google.golang.org/api/bigquery/v2"
|
|
|
|
)
|
|
|
|
|
|
|
|
var (
|
|
|
|
// See https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#timestamp-type.
|
|
|
|
timestampFormat = "2006-01-02 15:04:05.999999-07:00"
|
|
|
|
|
|
|
|
// See https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#schema.fields.name
|
|
|
|
validFieldName = regexp.MustCompile("^[a-zA-Z_][a-zA-Z0-9_]{0,127}$")
|
|
|
|
)
|
|
|
|
|
|
|
|
const nullableTagOption = "nullable"
|
|
|
|
|
|
|
|
func bqTagParser(t reflect.StructTag) (name string, keep bool, other interface{}, err error) {
|
|
|
|
name, keep, opts, err := fields.ParseStandardTag("bigquery", t)
|
|
|
|
if err != nil {
|
|
|
|
return "", false, nil, err
|
|
|
|
}
|
|
|
|
if name != "" && !validFieldName.MatchString(name) {
|
2019-03-17 20:19:56 +01:00
|
|
|
return "", false, nil, invalidFieldNameError(name)
|
2018-06-19 15:30:26 +02:00
|
|
|
}
|
|
|
|
for _, opt := range opts {
|
|
|
|
if opt != nullableTagOption {
|
|
|
|
return "", false, nil, fmt.Errorf(
|
|
|
|
"bigquery: invalid tag option %q. The only valid option is %q",
|
|
|
|
opt, nullableTagOption)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return name, keep, opts, nil
|
|
|
|
}
|
|
|
|
|
2019-03-17 20:19:56 +01:00
|
|
|
type invalidFieldNameError string
|
|
|
|
|
|
|
|
func (e invalidFieldNameError) Error() string {
|
|
|
|
return fmt.Sprintf("bigquery: invalid name %q of field in struct", string(e))
|
|
|
|
}
|
|
|
|
|
2018-06-19 15:30:26 +02:00
|
|
|
var fieldCache = fields.NewCache(bqTagParser, nil, nil)
|
|
|
|
|
|
|
|
var (
|
|
|
|
int64ParamType = &bq.QueryParameterType{Type: "INT64"}
|
|
|
|
float64ParamType = &bq.QueryParameterType{Type: "FLOAT64"}
|
|
|
|
boolParamType = &bq.QueryParameterType{Type: "BOOL"}
|
|
|
|
stringParamType = &bq.QueryParameterType{Type: "STRING"}
|
|
|
|
bytesParamType = &bq.QueryParameterType{Type: "BYTES"}
|
|
|
|
dateParamType = &bq.QueryParameterType{Type: "DATE"}
|
|
|
|
timeParamType = &bq.QueryParameterType{Type: "TIME"}
|
|
|
|
dateTimeParamType = &bq.QueryParameterType{Type: "DATETIME"}
|
|
|
|
timestampParamType = &bq.QueryParameterType{Type: "TIMESTAMP"}
|
|
|
|
numericParamType = &bq.QueryParameterType{Type: "NUMERIC"}
|
|
|
|
)
|
|
|
|
|
|
|
|
var (
|
|
|
|
typeOfDate = reflect.TypeOf(civil.Date{})
|
|
|
|
typeOfTime = reflect.TypeOf(civil.Time{})
|
|
|
|
typeOfDateTime = reflect.TypeOf(civil.DateTime{})
|
|
|
|
typeOfGoTime = reflect.TypeOf(time.Time{})
|
|
|
|
typeOfRat = reflect.TypeOf(&big.Rat{})
|
|
|
|
)
|
|
|
|
|
|
|
|
// A QueryParameter is a parameter to a query.
|
|
|
|
type QueryParameter struct {
|
|
|
|
// Name is used for named parameter mode.
|
|
|
|
// It must match the name in the query case-insensitively.
|
|
|
|
Name string
|
|
|
|
|
|
|
|
// Value is the value of the parameter.
|
|
|
|
//
|
|
|
|
// When you create a QueryParameter to send to BigQuery, the following Go types
|
|
|
|
// are supported, with their corresponding Bigquery types:
|
|
|
|
// int, int8, int16, int32, int64, uint8, uint16, uint32: INT64
|
|
|
|
// Note that uint, uint64 and uintptr are not supported, because
|
|
|
|
// they may contain values that cannot fit into a 64-bit signed integer.
|
|
|
|
// float32, float64: FLOAT64
|
|
|
|
// bool: BOOL
|
|
|
|
// string: STRING
|
|
|
|
// []byte: BYTES
|
|
|
|
// time.Time: TIMESTAMP
|
|
|
|
// *big.Rat: NUMERIC
|
|
|
|
// Arrays and slices of the above.
|
|
|
|
// Structs of the above. Only the exported fields are used.
|
|
|
|
//
|
2019-03-17 20:19:56 +01:00
|
|
|
// BigQuery does not support params of type GEOGRAPHY. For users wishing
|
|
|
|
// to parameterize Geography values, use string parameters and cast in the
|
|
|
|
// SQL query, e.g. `SELECT ST_GeogFromText(@string_param) as geo`
|
|
|
|
//
|
2018-06-19 15:30:26 +02:00
|
|
|
// When a QueryParameter is returned inside a QueryConfig from a call to
|
|
|
|
// Job.Config:
|
|
|
|
// Integers are of type int64.
|
|
|
|
// Floating-point values are of type float64.
|
|
|
|
// Arrays are of type []interface{}, regardless of the array element type.
|
|
|
|
// Structs are of type map[string]interface{}.
|
|
|
|
Value interface{}
|
|
|
|
}
|
|
|
|
|
|
|
|
func (p QueryParameter) toBQ() (*bq.QueryParameter, error) {
|
|
|
|
pv, err := paramValue(reflect.ValueOf(p.Value))
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
pt, err := paramType(reflect.TypeOf(p.Value))
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return &bq.QueryParameter{
|
|
|
|
Name: p.Name,
|
|
|
|
ParameterValue: &pv,
|
|
|
|
ParameterType: pt,
|
|
|
|
}, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
func paramType(t reflect.Type) (*bq.QueryParameterType, error) {
|
|
|
|
if t == nil {
|
|
|
|
return nil, errors.New("bigquery: nil parameter")
|
|
|
|
}
|
|
|
|
switch t {
|
|
|
|
case typeOfDate:
|
|
|
|
return dateParamType, nil
|
|
|
|
case typeOfTime:
|
|
|
|
return timeParamType, nil
|
|
|
|
case typeOfDateTime:
|
|
|
|
return dateTimeParamType, nil
|
|
|
|
case typeOfGoTime:
|
|
|
|
return timestampParamType, nil
|
|
|
|
case typeOfRat:
|
|
|
|
return numericParamType, nil
|
|
|
|
}
|
|
|
|
switch t.Kind() {
|
|
|
|
case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Uint8, reflect.Uint16, reflect.Uint32:
|
|
|
|
return int64ParamType, nil
|
|
|
|
|
|
|
|
case reflect.Float32, reflect.Float64:
|
|
|
|
return float64ParamType, nil
|
|
|
|
|
|
|
|
case reflect.Bool:
|
|
|
|
return boolParamType, nil
|
|
|
|
|
|
|
|
case reflect.String:
|
|
|
|
return stringParamType, nil
|
|
|
|
|
|
|
|
case reflect.Slice:
|
|
|
|
if t.Elem().Kind() == reflect.Uint8 {
|
|
|
|
return bytesParamType, nil
|
|
|
|
}
|
|
|
|
fallthrough
|
|
|
|
|
|
|
|
case reflect.Array:
|
|
|
|
et, err := paramType(t.Elem())
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return &bq.QueryParameterType{Type: "ARRAY", ArrayType: et}, nil
|
|
|
|
|
|
|
|
case reflect.Ptr:
|
|
|
|
if t.Elem().Kind() != reflect.Struct {
|
|
|
|
break
|
|
|
|
}
|
|
|
|
t = t.Elem()
|
|
|
|
fallthrough
|
|
|
|
|
|
|
|
case reflect.Struct:
|
|
|
|
var fts []*bq.QueryParameterTypeStructTypes
|
|
|
|
fields, err := fieldCache.Fields(t)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
for _, f := range fields {
|
|
|
|
pt, err := paramType(f.Type)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
fts = append(fts, &bq.QueryParameterTypeStructTypes{
|
|
|
|
Name: f.Name,
|
|
|
|
Type: pt,
|
|
|
|
})
|
|
|
|
}
|
|
|
|
return &bq.QueryParameterType{Type: "STRUCT", StructTypes: fts}, nil
|
|
|
|
}
|
|
|
|
return nil, fmt.Errorf("bigquery: Go type %s cannot be represented as a parameter type", t)
|
|
|
|
}
|
|
|
|
|
|
|
|
func paramValue(v reflect.Value) (bq.QueryParameterValue, error) {
|
|
|
|
var res bq.QueryParameterValue
|
|
|
|
if !v.IsValid() {
|
|
|
|
return res, errors.New("bigquery: nil parameter")
|
|
|
|
}
|
|
|
|
t := v.Type()
|
|
|
|
switch t {
|
|
|
|
case typeOfDate:
|
|
|
|
res.Value = v.Interface().(civil.Date).String()
|
|
|
|
return res, nil
|
|
|
|
|
|
|
|
case typeOfTime:
|
|
|
|
// civil.Time has nanosecond resolution, but BigQuery TIME only microsecond.
|
|
|
|
// (If we send nanoseconds, then when we try to read the result we get "query job
|
|
|
|
// missing destination table").
|
|
|
|
res.Value = CivilTimeString(v.Interface().(civil.Time))
|
|
|
|
return res, nil
|
|
|
|
|
|
|
|
case typeOfDateTime:
|
|
|
|
res.Value = CivilDateTimeString(v.Interface().(civil.DateTime))
|
|
|
|
return res, nil
|
|
|
|
|
|
|
|
case typeOfGoTime:
|
|
|
|
res.Value = v.Interface().(time.Time).Format(timestampFormat)
|
|
|
|
return res, nil
|
|
|
|
|
|
|
|
case typeOfRat:
|
|
|
|
res.Value = NumericString(v.Interface().(*big.Rat))
|
|
|
|
return res, nil
|
|
|
|
}
|
|
|
|
switch t.Kind() {
|
|
|
|
case reflect.Slice:
|
|
|
|
if t.Elem().Kind() == reflect.Uint8 {
|
|
|
|
res.Value = base64.StdEncoding.EncodeToString(v.Interface().([]byte))
|
|
|
|
return res, nil
|
|
|
|
}
|
|
|
|
fallthrough
|
|
|
|
|
|
|
|
case reflect.Array:
|
|
|
|
var vals []*bq.QueryParameterValue
|
|
|
|
for i := 0; i < v.Len(); i++ {
|
|
|
|
val, err := paramValue(v.Index(i))
|
|
|
|
if err != nil {
|
|
|
|
return bq.QueryParameterValue{}, err
|
|
|
|
}
|
|
|
|
vals = append(vals, &val)
|
|
|
|
}
|
|
|
|
return bq.QueryParameterValue{ArrayValues: vals}, nil
|
|
|
|
|
|
|
|
case reflect.Ptr:
|
|
|
|
if t.Elem().Kind() != reflect.Struct {
|
|
|
|
return res, fmt.Errorf("bigquery: Go type %s cannot be represented as a parameter value", t)
|
|
|
|
}
|
|
|
|
t = t.Elem()
|
|
|
|
v = v.Elem()
|
|
|
|
if !v.IsValid() {
|
|
|
|
// nil pointer becomes empty value
|
|
|
|
return res, nil
|
|
|
|
}
|
|
|
|
fallthrough
|
|
|
|
|
|
|
|
case reflect.Struct:
|
|
|
|
fields, err := fieldCache.Fields(t)
|
|
|
|
if err != nil {
|
|
|
|
return bq.QueryParameterValue{}, err
|
|
|
|
}
|
|
|
|
res.StructValues = map[string]bq.QueryParameterValue{}
|
|
|
|
for _, f := range fields {
|
|
|
|
fv := v.FieldByIndex(f.Index)
|
|
|
|
fp, err := paramValue(fv)
|
|
|
|
if err != nil {
|
|
|
|
return bq.QueryParameterValue{}, err
|
|
|
|
}
|
|
|
|
res.StructValues[f.Name] = fp
|
|
|
|
}
|
|
|
|
return res, nil
|
|
|
|
}
|
|
|
|
// None of the above: assume a scalar type. (If it's not a valid type,
|
|
|
|
// paramType will catch the error.)
|
|
|
|
res.Value = fmt.Sprint(v.Interface())
|
2019-03-17 20:19:56 +01:00
|
|
|
// Ensure empty string values are sent.
|
|
|
|
if res.Value == "" {
|
|
|
|
res.ForceSendFields = append(res.ForceSendFields, "Value")
|
|
|
|
}
|
2018-06-19 15:30:26 +02:00
|
|
|
return res, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
func bqToQueryParameter(q *bq.QueryParameter) (QueryParameter, error) {
|
|
|
|
p := QueryParameter{Name: q.Name}
|
|
|
|
val, err := convertParamValue(q.ParameterValue, q.ParameterType)
|
|
|
|
if err != nil {
|
|
|
|
return QueryParameter{}, err
|
|
|
|
}
|
|
|
|
p.Value = val
|
|
|
|
return p, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
var paramTypeToFieldType = map[string]FieldType{
|
|
|
|
int64ParamType.Type: IntegerFieldType,
|
|
|
|
float64ParamType.Type: FloatFieldType,
|
|
|
|
boolParamType.Type: BooleanFieldType,
|
|
|
|
stringParamType.Type: StringFieldType,
|
|
|
|
bytesParamType.Type: BytesFieldType,
|
|
|
|
dateParamType.Type: DateFieldType,
|
|
|
|
timeParamType.Type: TimeFieldType,
|
|
|
|
numericParamType.Type: NumericFieldType,
|
|
|
|
}
|
|
|
|
|
|
|
|
// Convert a parameter value from the service to a Go value. This is similar to, but
|
|
|
|
// not quite the same as, converting data values.
|
|
|
|
func convertParamValue(qval *bq.QueryParameterValue, qtype *bq.QueryParameterType) (interface{}, error) {
|
|
|
|
switch qtype.Type {
|
|
|
|
case "ARRAY":
|
|
|
|
if qval == nil {
|
|
|
|
return []interface{}(nil), nil
|
|
|
|
}
|
|
|
|
return convertParamArray(qval.ArrayValues, qtype.ArrayType)
|
|
|
|
case "STRUCT":
|
|
|
|
if qval == nil {
|
|
|
|
return map[string]interface{}(nil), nil
|
|
|
|
}
|
|
|
|
return convertParamStruct(qval.StructValues, qtype.StructTypes)
|
|
|
|
case "TIMESTAMP":
|
|
|
|
return time.Parse(timestampFormat, qval.Value)
|
|
|
|
case "DATETIME":
|
|
|
|
return parseCivilDateTime(qval.Value)
|
|
|
|
default:
|
|
|
|
return convertBasicType(qval.Value, paramTypeToFieldType[qtype.Type])
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// convertParamArray converts a query parameter array value to a Go value. It
|
|
|
|
// always returns a []interface{}.
|
|
|
|
func convertParamArray(elVals []*bq.QueryParameterValue, elType *bq.QueryParameterType) ([]interface{}, error) {
|
|
|
|
var vals []interface{}
|
|
|
|
for _, el := range elVals {
|
|
|
|
val, err := convertParamValue(el, elType)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
vals = append(vals, val)
|
|
|
|
}
|
|
|
|
return vals, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// convertParamStruct converts a query parameter struct value into a Go value. It
|
|
|
|
// always returns a map[string]interface{}.
|
|
|
|
func convertParamStruct(sVals map[string]bq.QueryParameterValue, sTypes []*bq.QueryParameterTypeStructTypes) (map[string]interface{}, error) {
|
|
|
|
vals := map[string]interface{}{}
|
|
|
|
for _, st := range sTypes {
|
|
|
|
if sv, ok := sVals[st.Name]; ok {
|
|
|
|
val, err := convertParamValue(&sv, st.Type)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
vals[st.Name] = val
|
|
|
|
} else {
|
|
|
|
vals[st.Name] = nil
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return vals, nil
|
|
|
|
}
|