2017-05-11 16:39:54 +02:00
|
|
|
// Copyright 2016 Google Inc. All Rights Reserved.
|
|
|
|
//
|
|
|
|
// 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 (
|
|
|
|
"golang.org/x/net/context"
|
|
|
|
bq "google.golang.org/api/bigquery/v2"
|
|
|
|
)
|
|
|
|
|
|
|
|
// CopyConfig holds the configuration for a copy job.
|
|
|
|
type CopyConfig struct {
|
|
|
|
// Srcs are the tables from which data will be copied.
|
|
|
|
Srcs []*Table
|
|
|
|
|
|
|
|
// Dst is the table into which the data will be copied.
|
|
|
|
Dst *Table
|
|
|
|
|
|
|
|
// CreateDisposition specifies the circumstances under which the destination table will be created.
|
|
|
|
// The default is CreateIfNeeded.
|
|
|
|
CreateDisposition TableCreateDisposition
|
|
|
|
|
|
|
|
// WriteDisposition specifies how existing data in the destination table is treated.
|
2018-01-16 14:20:59 +01:00
|
|
|
// The default is WriteEmpty.
|
2017-05-11 16:39:54 +02:00
|
|
|
WriteDisposition TableWriteDisposition
|
2018-01-16 14:20:59 +01:00
|
|
|
|
|
|
|
// The labels associated with this job.
|
|
|
|
Labels map[string]string
|
2018-03-19 16:51:38 +01:00
|
|
|
|
|
|
|
// Custom encryption configuration (e.g., Cloud KMS keys).
|
|
|
|
DestinationEncryptionConfig *EncryptionConfig
|
2018-01-16 14:20:59 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
func (c *CopyConfig) toBQ() *bq.JobConfiguration {
|
|
|
|
var ts []*bq.TableReference
|
|
|
|
for _, t := range c.Srcs {
|
|
|
|
ts = append(ts, t.toBQ())
|
|
|
|
}
|
|
|
|
return &bq.JobConfiguration{
|
|
|
|
Labels: c.Labels,
|
|
|
|
Copy: &bq.JobConfigurationTableCopy{
|
2018-03-19 16:51:38 +01:00
|
|
|
CreateDisposition: string(c.CreateDisposition),
|
|
|
|
WriteDisposition: string(c.WriteDisposition),
|
|
|
|
DestinationTable: c.Dst.toBQ(),
|
|
|
|
DestinationEncryptionConfiguration: c.DestinationEncryptionConfig.toBQ(),
|
|
|
|
SourceTables: ts,
|
2018-01-16 14:20:59 +01:00
|
|
|
},
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
func bqToCopyConfig(q *bq.JobConfiguration, c *Client) *CopyConfig {
|
|
|
|
cc := &CopyConfig{
|
|
|
|
Labels: q.Labels,
|
|
|
|
CreateDisposition: TableCreateDisposition(q.Copy.CreateDisposition),
|
|
|
|
WriteDisposition: TableWriteDisposition(q.Copy.WriteDisposition),
|
|
|
|
Dst: bqToTable(q.Copy.DestinationTable, c),
|
2018-03-19 16:51:38 +01:00
|
|
|
DestinationEncryptionConfig: bqToEncryptionConfig(q.Copy.DestinationEncryptionConfiguration),
|
2018-01-16 14:20:59 +01:00
|
|
|
}
|
|
|
|
for _, t := range q.Copy.SourceTables {
|
|
|
|
cc.Srcs = append(cc.Srcs, bqToTable(t, c))
|
|
|
|
}
|
|
|
|
return cc
|
2017-05-11 16:39:54 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// A Copier copies data into a BigQuery table from one or more BigQuery tables.
|
|
|
|
type Copier struct {
|
2018-01-16 14:20:59 +01:00
|
|
|
JobIDConfig
|
2017-05-11 16:39:54 +02:00
|
|
|
CopyConfig
|
|
|
|
c *Client
|
|
|
|
}
|
|
|
|
|
|
|
|
// CopierFrom returns a Copier which can be used to copy data into a
|
2018-01-16 14:20:59 +01:00
|
|
|
// BigQuery table from one or more BigQuery tables.
|
2017-05-11 16:39:54 +02:00
|
|
|
// The returned Copier may optionally be further configured before its Run method is called.
|
|
|
|
func (t *Table) CopierFrom(srcs ...*Table) *Copier {
|
|
|
|
return &Copier{
|
|
|
|
c: t.c,
|
|
|
|
CopyConfig: CopyConfig{
|
|
|
|
Srcs: srcs,
|
|
|
|
Dst: t,
|
|
|
|
},
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Run initiates a copy job.
|
|
|
|
func (c *Copier) Run(ctx context.Context) (*Job, error) {
|
2018-01-16 14:20:59 +01:00
|
|
|
return c.c.insertJob(ctx, c.newJob(), nil)
|
|
|
|
}
|
|
|
|
|
|
|
|
func (c *Copier) newJob() *bq.Job {
|
|
|
|
return &bq.Job{
|
2018-05-02 18:09:45 +02:00
|
|
|
JobReference: c.JobIDConfig.createJobRef(c.c),
|
2018-01-16 14:20:59 +01:00
|
|
|
Configuration: c.CopyConfig.toBQ(),
|
2017-09-30 16:27:27 +02:00
|
|
|
}
|
2017-05-11 16:39:54 +02:00
|
|
|
}
|