v0.4.0

Compare Source

• bigquery:
  -NewGCSReference is now a function, not a method on Client.

  • Table.LoaderFrom now accepts a ReaderSource, enabling
    loading data into a table from a file or any io.Reader.

  • Client.Table and Client.OpenTable have been removed.
    Replace

    client.OpenTable("project", "dataset", "table")

    with

    client.DatasetInProject("project", "dataset").Table("table")

  • Client.CreateTable has been removed.
    Replace

    client.CreateTable(ctx, "project", "dataset", "table")

    with

    client.DatasetInProject("project", "dataset").Table("table").Create(ctx)

  • Dataset.ListTables have been replaced with Dataset.Tables.
    Replace

    tables, err := ds.ListTables(ctx)

    with

    it := ds.Tables(ctx)
    for {
        table, err := it.Next()
        if err == iterator.Done {
            break
        }
        if err != nil {
            // TODO: Handle error.
        }
        // TODO: use table.
    }

  • Client.Read has been replaced with Job.Read, Table.Read and Query.Read.
    Replace

    it, err := client.Read(ctx, job)

    with

    it, err := job.Read(ctx)

    and similarly for reading from tables or queries.

  • The iterator returned from the Read methods is now named RowIterator. Its
    behavior is closer to the other iterators in these libraries. It no longer
    supports the Schema method; see the next item.
    Replace

    for it.Next(ctx) {
        var vals ValueList
        if err := it.Get(&vals); err != nil {
            // TODO: Handle error.
        }
        // TODO: use vals.
    }
    if err := it.Err(); err != nil {
        // TODO: Handle error.
    }

    with
    for {
    var vals ValueList
    err := it.Next(&vals)
    if err == iterator.Done {
    break
    }
    if err != nil {
    // TODO: Handle error.
    }
    // TODO: use vals.
    }
    Instead of the RecordsPerRequest(n) option, write

    it.PageInfo().MaxSize = n

    Instead of the StartIndex(i) option, write

    it.StartIndex = i

  • ValueLoader.Load now takes a Schema in addition to a slice of Values.
    Replace

    func (vl *myValueLoader) Load(v []bigquery.Value)

    with

    func (vl *myValueLoader) Load(v []bigquery.Value, s bigquery.Schema)

  • Table.Patch is replace by Table.Update.
    Replace

    p := table.Patch()
    p.Description("new description")
    metadata, err := p.Apply(ctx)

    with

    metadata, err := table.Update(ctx, bigquery.TableMetadataToUpdate{
        Description: "new description",
    })

  • Client.Copy is replaced by separate methods for each of its four functions.
    All options have been replaced by struct fields.

    • To load data from Google Cloud Storage into a table, use Table.LoaderFrom.

      Replace

      client.Copy(ctx, table, gcsRef)

      with

      table.LoaderFrom(gcsRef).Run(ctx)

      Instead of passing options to Copy, set fields on the Loader:

      loader := table.LoaderFrom(gcsRef)
      loader.WriteDisposition = bigquery.WriteTruncate

    • To extract data from a table into Google Cloud Storage, use
      Table.ExtractorTo. Set fields on the returned Extractor instead of
      passing options.

      Replace

      client.Copy(ctx, gcsRef, table)

      with

      table.ExtractorTo(gcsRef).Run(ctx)

    • To copy data into a table from one or more other tables, use
      Table.CopierFrom. Set fields on the returned Copier instead of passing options.

      Replace

      client.Copy(ctx, dstTable, srcTable)

      with

      dst.Table.CopierFrom(srcTable).Run(ctx)

    • To start a query job, create a Query and call its Run method. Set fields
      on the query instead of passing options.

      Replace

      client.Copy(ctx, table, query)

      with

      query.Run(ctx)

  • Table.NewUploader has been renamed to Table.Uploader. Instead of options,
    configure an Uploader by setting its fields.
    Replace

    u := table.NewUploader(bigquery.UploadIgnoreUnknownValues())

    with

    u := table.NewUploader(bigquery.UploadIgnoreUnknownValues())
    u.IgnoreUnknownValues = true

• pubsub: remove pubsub.Done. Use iterator.Done instead, where iterator is the package
  google.golang.org/api/iterator.

v1.65.0: Release 1.65.0

Compare Source

Dependencies

• Change support policy to cover only the latest TWO releases of Go, matching the policy for Go itself. See #​7249 for more information. (#​7250)
• Update x/net/http2 to address CVE-2023-45288 (#​7282)

Behavior Changes

• credentials/tls: clients and servers will now reject connections that don't support ALPN when environment variable GRPC_ENFORCE_ALPN_ENABLED is set to "true" (case insensitive). (#​7184)
  • NOTE: this behavior will become the default in a future release.
• metadata: remove String method from MD to make printing more consistent (#​7373)

New Features

• grpc: add WithMaxCallAttempts to configure gRPC's retry behavior per-channel. (#​7229)
  • Special Thanks: @​imoore76

Bug Fixes

• ringhash: properly apply endpoint weights instead of ignoring them (#​7156)
• xds: fix a bug that could cause xds-enabled servers to stop accepting new connections after handshaking errors (#​7128)
  • Special Thanks: @​bozaro

v1.64.1: Release 1.64.1

Compare Source

Dependencies

• Update x/net/http2 to address CVE-2023-45288 (#​7352)
• metadata: remove String method from MD to make printing consistent (#​7374)