Gerenciar esquemas de chave de linha

Console

Para definir um esquema de chave de linha usando o Google Cloud console, siga estas etapas:

1. No Google Cloud console, abra a página Instâncias do Bigtable.

   Acessar a lista de instâncias

2. Selecione uma instância na lista.

3. No menu de navegação, clique em Bigtable Studio.

   O painel Explorer mostra uma lista de tabelas, visualizações e consultas na instância.

4. Na lista Tabelas, para a tabela em que você quer criar um esquema de chave de linha , clique no menu more_vert Ver ações e, em seguida, clique em Criar esquema de chave de linha.

   A guia Esquema de chave de linha será aberta.

5. Na lista Codificação, selecione um tipo de codificação para o esquema de chave de linha.

6. Se você selecionou DelimitedBytes, no campo Delimitador, insira um delimitador que separe os segmentos nas chaves de linha atuais. O valor padrão é um símbolo de hash (#).

7. No campo Segmento, insira um nome para o segmento, como device_type.

8. Na lista Tipo, selecione o tipo de dados do segmento de chave de linha.

9. Dependendo do tipo de dados selecionado, na lista Codificação de bytes, deixe o tipo de codificação padrão do segmento de chave de linha ou mude-o.

10. Opcional: se o segmento de chave de linha tiver mais de uma parte, clique em Adicionar segmento de chave de linha para adicionar outros campos.

11. Clique em Salvar.

gcloud

Para definir um esquema de chave de linha usando a CLI gcloud, use o gcloud beta bigtable tables update comando com um arquivo YAML ou JSON que defina o esquema.

gcloud beta bigtable tables update TABLE_ID \
  --instance=INSTANCE_ID \
  --row-key-schema-definition-file=ROW_KEY_SCHEMA_DEFINITION_FILE \
  --row-key-schema-pre-encoded-bytes

Substitua:

• TABLE_ID: o ID exclusivo da tabela que você quer atualizar
• INSTANCE_ID: o ID da instância em que a tabela está localizada
• ROW_KEY_SCHEMA_DEFINITION_FILE: o caminho para o arquivo YAML ou JSON que define o esquema de chave de linha. Para exemplos de como esses arquivos devem ser, consulte Arquivos de esquema de exemplo.

Por padrão, a codificação Base64 é aplicada a todos os campos binários em um arquivo YAML ou JSON, como encoding.delimitedBytes.delimiter para o delimitador de chave de linha. A flag --row-key-schema-pre-encoded-bytes informa ao Bigtable que os campos binários estão codificados no arquivo e não precisam ser codificados novamente.

Go

Use a função UpdateTableWithRowKeySchema para criar um esquema de chave de linha para uma tabela.

func (ac *AdminClient) UpdateTableWithRowKeySchema(ctx context.Context, tableID
string, rowKeySchema StructType) error

O exemplo a seguir cria um esquema chamado rks e o adiciona à tabela.

rks := StructType{
Fields: []StructField{
    {FieldName: "key1", FieldType: Int64Type{Encoding: Int64OrderedCodeBytesEncoding{}}},
    {FieldName: "key2", FieldType: StringType{Encoding: StringUtf8BytesEncoding{}}},
  },
  Encoding: StructDelimitedBytesEncoding{Delimiter: []byte{'#'}}}

err := c.UpdateTableWithRowKeySchema(context.Background(), "my-table", rks)

Console

Para excluir o esquema de chave de linha de uma tabela usando o Google Cloud console, siga estas etapas:

1. No Google Cloud console, abra a página Instâncias do Bigtable.

   Acessar a lista de instâncias

2. Selecione uma instância na lista.

3. No menu de navegação, clique em Bigtable Studio.

   O painel Explorer mostra uma lista de tabelas, visualizações e consultas na instância.

4. Na lista de tabelas, clique na tabela com o esquema de chave de linha que você quer excluir.

5. Clique no menu more_vert Ver ações do esquema de chave de linha que você quer excluir.

6. Clique em Excluir.

gcloud

Para excluir o esquema de chave de linha de uma tabela, use o gcloud beta bigtable tables update comando com a --clear-row-key-schema flag.

  gcloud beta bigtable tables update TABLE_NAME \
    --instance=INSTANCE_ID \
    --clear-row-key-schema

Substitua:

• TABLE_NAME: o nome exclusivo da tabela da qual você quer excluir o esquema de chave de linha
• INSTANCE_ID: o ID da instância em que a tabela está localizada

Go

Use a função UpdateTableRemoveRowKeySchema para limpar o esquema de chave de linha de uma tabela:

func (ac *AdminClient) UpdateTableRemoveRowKeySchema(ctx context.Context,
tableID string) error

Console

Para ver o esquema de chave de linha de uma tabela usando o Google Cloud console, siga estas etapas:

1. No Google Cloud console, abra a página Instâncias do Bigtable.

   Acessar a lista de instâncias

2. Clique na instância em que está o esquema de chave de linha da tabela que você quer ver.

3. No menu de navegação, clique em Bigtable Studio.

   O painel Explorer mostra uma lista de tabelas, visualizações e consultas na instância.

4. Na lista de tabelas, clique na tabela com o esquema de chave de linha que você quer ver.

5. Clique no esquema de chave de linha.

   A guia de detalhes será aberta.

gcloud

Para ver um esquema de chave de linha, use o gcloud beta bigtable tables describe comando:

  gcloud bigtable tables describe TABLE_NAME \
    --instance=INSTANCE_ID

Substitua:

• TABLE_NAME: o nome exclusivo da tabela cujo esquema de chave de linha você quer ver
• INSTANCE_ID: o ID da instância em que a tabela está localizada

A resposta no terminal é semelhante à seguinte. Se a tabela não tiver um esquema de chave de linha, a resposta não incluirá uma seção rowKeySchema.

columnFamilies:
  cf: {}
createTime: '2025-05-28T17:25:39.433058Z'
granularity: MILLIS
name: projects/<project>/instances/<instance>/tables/<table>
rowKeySchema:
  encoding:
    delimitedBytes:
      delimiter: Iw==
  fields:
  - fieldName: <field_name_1>
    type:
      stringType:
        encoding:
          utf8Bytes: {}
  - fieldName: <field_name_2>
    type:
      intType:
        encoding:
          bigEndianBytes: {}
  - fieldName: <field_name_3>
    type:
      timestampType:
        encoding:
          unixMicrosInt64: {
              encoding: {
                  orderedCodeBytes: {}
              }
          }
updateTime: '2025-05-28T17:25:39.433058Z'

Go

O campo RowKeySchema está disponível como parte do objeto TableInfo, e você o recupera usando o método .TableInfo().

type TableInfo struct {
  ...
  RowKeySchema          *StructType
}

func (ac *AdminClient) TableInfo(ctx context.Context, table string) (*TableInfo, error)

YAML

fields:
  - fieldName: "user_id"
    type:
      stringType:
        encoding:
          utf8Bytes: {}
  - fieldName: "purchase_date"
    type:
      stringType:
        encoding:
          utf8Bytes: {}
  - fieldName: "order_number"
    type:
      stringType:
        encoding:
          utf8Bytes: {}
encoding:
  delimitedBytes:
    delimiter: "Iw=="

JSON

{
  "fields": [
    {
      "fieldName": "user_id",
      "type": {
        "stringType": {
          "encoding": {
            "utf8Bytes": {}
          }
        }
      }
    },
    {
      "fieldName": "purchase_date",
      "type": {
        "stringType": {
          "encoding": {
            "utf8Bytes": {}
          }
        }
      }
    },
    {
      "fieldName": "order_number",
      "type": {
        "stringType": {
          "encoding": {
            "utf8Bytes": {}
          }
        }
      }
    }
  ],
  "encoding": {
    "delimitedBytes": {
      "delimiter": "Iw=="
    }
  }
}