BigtableSource

Die Cloud Bigtable-Quelle zum Importieren von Daten.

JSON-Darstellung
{
  "projectId": string,
  "instanceId": string,
  "tableId": string,
  "bigtableOptions": {
    object (BigtableOptions)
  }
}
Felder
projectId

string

Die Projekt-ID des Projekts, das die Bigtable-Quelle enthält. Die Länge ist auf 128 Zeichen begrenzt. Wenn keine Angabe erfolgt, wird die Projekt-ID von der übergeordneten Anfrage übernommen.

instanceId

string

Erforderlich. Die Instanz-ID der Cloud Bigtable-Instanz, die importiert werden soll.

tableId

string

Erforderlich. Die Tabellen-ID der Cloud Bigtable-Tabelle, die importiert werden soll.

bigtableOptions

object (BigtableOptions)

Erforderlich. Bigtable-Optionen mit Informationen, die zum Parsen von Daten in typisierte Strukturen erforderlich sind. Das können beispielsweise Annotationen für Spaltentypen sein.

BigtableOptions

Das Bigtable-Options-Objekt, das Informationen zur Unterstützung des Imports enthält.

JSON-Darstellung
{
  "keyFieldName": string,
  "families": {
    string: {
      object (BigtableColumnFamily)
    },
    ...
  }
}
Felder
keyFieldName

string

Der Feldname, der zum Speichern des Zeilenschlüsselwerts im Dokument verwendet wird. Der Name muss diesem Muster entsprechen: [a-zA-Z0-9][a-zA-Z0-9-_]*.

families

map (key: string, value: object (BigtableColumnFamily))

Die Zuordnung von Familiennamen zu einem Objekt, das Informationen auf Spaltenfamilienebene für die angegebene Spaltenfamilie enthält. Wenn eine Familie in dieser Zuordnung nicht vorhanden ist, wird sie ignoriert.

BigtableColumnFamily

Die Spaltenfamilie der Bigtable-Tabelle.

JSON-Darstellung
{
  "fieldName": string,
  "encoding": enum (Encoding),
  "type": enum (Type),
  "columns": [
    {
      object (BigtableColumn)
    }
  ]
}
Felder
fieldName

string

Der Feldname, der für diese Spaltenfamilie im Dokument verwendet werden soll. Der Name muss diesem Muster entsprechen: [a-zA-Z0-9][a-zA-Z0-9-_]*. Wenn er nicht festgelegt ist, wird er nach bestem Wissen aus dem Familiennamen geparst. Aufgrund unterschiedlicher Namensmuster kann es jedoch zu Konflikten zwischen Feldnamen kommen, für die das Parsing-Verhalten nicht definiert ist.

encoding

enum (Encoding)

Der Codierungsmodus der Werte, wenn der Typ nicht STRING ist. Zulässige Codierungswerte:

  • TEXT: Gibt an, dass die Werte alphanumerische Textstrings sind.
  • BINARY: Gibt an, dass die Werte mit der Funktionsfamilie HBase Bytes.toBytes codiert werden. Dies kann für eine bestimmte Spalte überschrieben werden, indem Sie diese Spalte in columns auflisten und eine Codierung dafür angeben.
type

enum (Type)

Der Typ der Werte in dieser Spaltenfamilie. Die Werte müssen mit der Funktion HBase Bytes.toBytes codiert werden, wenn der Codierungswert auf BINARY festgelegt ist.

columns[]

object (BigtableColumn)

Die Liste der Objekte, die Informationen auf Spaltenebene für jede Spalte enthält. Wenn eine Spalte nicht in dieser Liste enthalten ist, wird sie ignoriert.

Encoding

Der Codierungsmodus einer Bigtable-Spalte oder -Spaltenfamilie.

Enums
ENCODING_UNSPECIFIED Die Codierung ist nicht angegeben.
TEXT Textcodierung.
BINARY Binärcodierung.

Type

Der Typ der Werte in einer Bigtable-Spalte oder -Spaltenfamilie. Die Werte müssen mit der Funktion HBase Bytes.toBytes codiert werden, wenn der Codierungswert auf BINARY festgelegt ist.

Enums
TYPE_UNSPECIFIED Der Typ ist nicht angegeben.
STRING String-Typ.
NUMBER Numerischer Typ.
INTEGER Ganzzahltyp.
VAR_INTEGER Ganzzahltyp mit variabler Länge.
BIG_NUMERIC BigDecimal-Typ.
BOOLEAN Boolescher Typ.
JSON JSON-Typ.

BigtableColumn

Die Spalte der Bigtable.

JSON-Darstellung
{
  "qualifier": string,
  "fieldName": string,
  "encoding": enum (Encoding),
  "type": enum (Type)
}
Felder
qualifier

string (bytes format)

Erforderlich. Qualifier der Spalte. Wenn sie nicht mit UTF-8 decodiert werden kann, verwenden Sie stattdessen einen base64-codierten String.

Ein base64-codierter String.

fieldName

string

Der Feldname, der für diese Spalte im Dokument verwendet werden soll. Der Name muss diesem Muster entsprechen: [a-zA-Z0-9][a-zA-Z0-9-_]*. Wenn er nicht festgelegt ist, wird er nach bestem Wissen aus den Qualifier-Bytes geparst. Aufgrund unterschiedlicher Namensmuster kann es jedoch zu Konflikten zwischen Feldnamen kommen, für die das Parsing-Verhalten nicht definiert ist.

encoding

enum (Encoding)

Der Codierungsmodus der Werte, wenn der Typ nicht STRING ist. Zulässige Codierungswerte:

  • TEXT: Gibt an, dass die Werte alphanumerische Textstrings sind.
  • BINARY: Gibt an, dass die Werte mit der Funktionsfamilie HBase Bytes.toBytes codiert werden. Dies kann für eine bestimmte Spalte überschrieben werden, indem Sie diese Spalte in columns auflisten und eine Codierung dafür angeben.
type

enum (Type)

Der Typ der Werte in dieser Spaltenfamilie. Die Werte müssen mit der Funktion HBase Bytes.toBytes codiert werden, wenn der Codierungswert auf BINARY festgelegt ist.