Przejdź do treści
Biblioteka skilli
Dane i analityka · Budowanie i kod

bigtable-basics

/bigtable-basics

Projektuje instancje, tabele i klucze wierszy w Bigtable, pisze zapytania i kod klienta oraz diagnozuje gorące węzły.

Licencja
Apache-2.0
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Projektuje instancje, tabele i klucze wierszy w Bigtable, pisze zapytania i kod klienta oraz diagnozuje gorące węzły.

Oryginalny opis (EN)

Provisions instances and tables, designs performant schemas, and queries data in Bigtable. Use when designing Bigtable row keys, configuring column families, writing SQL queries or client library code (Java, Go, Python) for Bigtable, or diagnosing performance/hotspotting issues. Also use when provisioning Bigtable clusters using gcloud or cbt CLIs. Don't use for generic Cloud SQL administration.

Jak działa

  1. Core Principles
  2. Quick Recipes
  3. Reference Guides
  4. Common Workflows
  5. External Resources
Sekcje z nagłówków SKILL.md, w oryginale · 113 linii, 577 słów
Podgląd SKILL.md
---
name: bigtable-basics
description: >-
  Provisions instances and tables, designs performant schemas, and queries data in Bigtable. Use when designing Bigtable row keys, configuring column families, writing SQL queries or client library code (Java, Go, Python) for Bigtable, or diagnosing performance/hotspotting issues. Also use when provisioning Bigtable clusters using gcloud or cbt CLIs. Don't use for generic Cloud SQL administration.
metadata:
  version: v3
  publisher: google
  category: Databases
license: Apache-2.0
---

# Bigtable Basics

This skill provides core workflows and guidance for administering and developing
with Google Bigtable.

## Core Principles

-   **Control Plane vs. Data Plane:**
    -   Use **`gcloud`** for Control Plane & DDL operations: Manage Instances,
        Clusters, App Profiles, Backups, and IAM. Manage schemas: Create,
        update, and delete Tables, Column Families, Logical Views, Materialized
        Views, and Authorized Views.
    -   Use **`cbt`** for Data Plane operations: Reading, writing, and
        inspecting data.
-   **Performance First:** Bigtable is a NoSQL database. Efficiency is tied to
    Row Key design. Always warn about Full Table Scans.
-   **Client Selection:** For production use cases, prefer **Java** or **Go**
    for their superior performance and feature coverage compared to other
    languages.
-   **Observability:** When diagnosing performance or hotspotting, **always**
    mention **Key Visualizer** (via Cloud Console) as the primary diagnostic
    tool because it provides the most granular view of access patterns across
    row keys. This should be followed by the hot-tablets tool and table stats in
    gcloud CLI and `include-stats=full` option under `cbt read` to diagnose slow
    queries.

> [!IMPORTANT] **Safety Rule:** You MUST obtain explicit user confirmation
> before making non-emulator database changes. You MUST mention this safety
> requirement when providing commands or instructions that modify the database
> structure or data.

## Quick Recipes

### 1. Querying Data

Use SQL for complex transforms or aggregations and key-value APIs for simpler
query patterns. *Note: Use exact match, prefix (`_key LIKE 'myprefix%'`), or
range predicates on `_key` to avoid expensive unbounded scans. Recommend
explicit row ranges (`_key BETWEEN 'start' AND 'end'`) as a more performant
alternative to prefix matches where possible.*

If expensive scans (either unbounded or prefix or range queries scanning a large
range) are unavoidable due to multiple access patterns that can’t all be
accommodated in a single schema, consider one of these two options:

-   If the query will be used in user facing and/or latency sensitive
    applications, use continuous materialized views with keys optimized for the
    additional access patterns.
-   If secondary access patterns are infrequent, batch patterns like ETL, ML
    model training or analytical read-only tasks, use Bigtable Data Boost
    instead.

### 2. Manipulating Data

Use key-value APIs for insert, update, increment and delete operations. SQL API
is read-only.

### 3. Data Model Definition (DDL)

SQL API doesn't support DDL operations. Table creation, deletion, updates should
be made using gcloud CLI. Logical Views and Continuous Materialized Views are
defined as SQL queries but they must be created using gcloud CLI.

## Reference Guides

-   **CLI Operations**:
    -   [infrastructure_management.md](references/infrastructure_management.md):
        Provisioning instances, clusters, and table schemas.
    -   [cli_data_access.md](references/cli_data_access.md): Reading and writing
        data via the `cbt` CLI.
-   **Design & Discovery**:
    -   [schema_design.md](references/schema_design.md): Best practices for row
        keys and performance with tables and continuous materialized views.
    -   [dataplex.md](references/dataplex.md): Data catalog search for Bigtable
        assets.
-   **Querying & Code**:
    -   [sql_guide.md](references/sql_guide.md): Querying structured row keys
        via SQL and CLI.
    -   [client_libraries.md](references/client_libraries.md): Patterns for
        high-performance Go/Java/Python code.

## Common Workflows

### Schema Evolution (DevOps)

1.  **Prefer Terraform** for production schema changes to prevent accidental
    data loss.
2.  For manual `cbt` changes, first check the existing state by listing the
    table's column families and GC policies before proposing any modifications:

    ```bash
    cbt ls {table}
    ```

    If modifications are needed, create the family or update the GC policy:

    ```bash
    cbt createfamily {table} {family}
    cbt setgcpolicy {table} {family} "maxversions=5 AND maxage=30d"
    ```

3.  Reference
    [infrastructure_management.md](references/infrastructure_management.md) for
    full syntax.

## External Resources

*   [Cloud Bigtable Documentation](https://cloud.google.com/bigtable/docs)
*   [Bigtable SQL Reference](https://cloud.google.com/bigtable/docs/googlesql-overview)
*   [cbt CLI Reference](https://cloud.google.com/bigtable/docs/cbt-reference)
*   [gcloud bigtable Reference](https://cloud.google.com/sdk/gcloud/reference/bigtable)
Pliki w paczce (8)
  • SKILL.md 5 KB
  • assets/row_key_schema.yaml 1 KB
  • references/cli_data_access.md 2 KB
  • references/client_libraries.md 2 KB
  • references/dataplex.md 1 KB
  • references/infrastructure_management.md 3 KB
  • references/schema_design.md 8 KB
  • references/sql_guide.md 7 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · googlecloudplatform/data-agent-kit-plugin100Apache-2.0
google/skills100Apache-2.0
hamzabellouch/agent-skills100MIT
gemini-cli-extensions/data-agent-kit-starter-pack100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki d12e67bc9434 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100bigtable
    Zarządza instancjami i tabelami Google Bigtable, projektuje schematy i odpytuje dane przez SQL lub biblioteki klienckie.
  • 100spanner-basics
    Pomaga tworzyć instancje i bazy Cloud Spanner w Google Cloud, projektować wydajne schematy i klucze główne, pisać zapytania SQL i kod klienta oraz diagnozować wydajność.
  • 90gcp-bigtable-architect
    Projektuje i sprawdza schemat oraz instancję Google Cloud Bigtable: klucze wierszy, replikację, zasady usuwania wersji i koszty.
  • 100spanner-basics
    Pomaga uruchamiać instancje i bazy Spanner, projektować klucze główne i schematy, pisać zapytania i diagnozować wydajność.
  • 100sql-development
    Wspiera T-SQL, procedury składowane i administrację MS SQL Server: zapytania, schematy, strojenie wydajności, kopie zapasowe, konfigurację bezpieczeństwa i funkcje SQL Server 2025+.
  • 100bigquery-basics
    Zarządza zbiorami danych, tabelami i zadaniami w BigQuery: uruchamia zapytania SQL i podstawowe ładowanie danych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.