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

spanner-basics

/spanner-basics

Pomaga uruchamiać instancje i bazy Spanner, projektować klucze główne i schematy, pisać zapytania i diagnozować wydajność.

Repozytorium
aidentity ↗
Licencja
MIT
Ostatnia zmiana repozytorium
28.10.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
9
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Pomaga uruchamiać instancje i bazy Spanner, projektować klucze główne i schematy, pisać zapytania i diagnozować wydajność.

Oryginalny opis (EN)

Assists in provisioning instances and databases, designing performant schemas, and querying data in Spanner. Use when designing primary keys, writing SQL queries or client library code, or diagnosing performance issues.

Jak działa

  1. Core Principles
  2. Safety
  3. Common Workflows
  4. Reference Directory
Sekcje z nagłówków SKILL.md, w oryginale · 44 linii, 368 słów
Podgląd SKILL.md
---
name: spanner-basics
metadata:
  category: Databases
description: >-
  Assists in provisioning instances and databases, designing performant schemas, and querying data in Spanner. Use when designing primary keys, writing SQL queries or client library code, or diagnosing performance issues.
---

# Spanner Basics

This skill provides core workflows and guidance for administering and developing with Google Cloud Spanner, a fully managed, mission-critical database service offering global transactional consistency and automatic, synchronous replication for high availability.

## Core Principles

-   **Performance First:** Spanner scales horizontally. Efficiency is tied to
    Primary Key design. Always warn against using monotonically increasing/decreasing
    values (like sequential timestamps) as the first part of a primary key to avoid hotspots.
-   **Schema Design:** Prefer interleaved tables for strongly related parent-child data
    that is frequently accessed together.

## Safety

> [!CAUTION] **CRITICAL INSTRUCTION:** You MUST obtain explicit user confirmation before making any non-emulator database changes (DML or DDL) or destructive operations (such as dropping tables, indexes, or any other Spanner resources). Do not execute them automatically; instead, output the command (e.g., `gcloud spanner databases ddl update`) and ask for explicit user approval.
> When database access is unavailable or authentication fails, do not block on trying to verify the existence of the instance, database, or table. Assume the provided resources exist and directly generate the DDL commands.

## Common Workflows

### Schema Evolution & DDL

1.  Use `gcloud spanner databases ddl update` to apply schema updates (such as CREATE, ALTER, or DROP tables and indexes).
2.  Reference [schema-design.md](references/schema-design.md) for guidelines on primary key selection and interleaved tables.

### Diagnosing Performance Issues

1.  Use `SPANNER_SYS` tables to identify slow or resource-intensive queries.
2.  For example, query `SPANNER_SYS.QUERY_STATS_TOP_HOUR` to find queries with the highest CPU usage.

## Reference Directory

- [Core Concepts](references/core-concepts.md): Explanation of Spanner internals, architecture, and design.
- [CLI Usage](references/cli-usage.md): Essential `gcloud spanner` command-line operations for managing instances and databases.
- [IAM Security](references/iam-security.md): Roles, permissions, and data governance best practices for Spanner.
- [Client Library Usage](references/client-library-usage.md): Using Google Cloud client libraries for Spanner (Java, Go, Python, Node.js).
- [Terraform Usage](references/terraform-usage.md): Infrastructure as Code examples for provisioning Spanner instances and databases.
- [MCP Usage](references/mcp-usage.md): Using the Spanner remote MCP server.
- [PostgreSQL Dialect](references/postgresql-dialect.md): Best practices and examples for using the PostgreSQL interface in Spanner.
- [Schema Design](references/schema-design.md): Guidelines on primary key selection and interleaved tables for performance.

If you need product information that's not found in these references, use the
`search_documents` tool of the Developer Knowledge MCP server.
Pliki w paczce (9)
  • SKILL.md 3 KB
  • references/cli-usage.md 1 KB
  • references/client-library-usage.md 4 KB
  • references/core-concepts.md 1 KB
  • references/iam-security.md 1 KB
  • references/mcp-usage.md 2 KB
  • references/postgresql-dialect.md 1 KB
  • references/schema-design.md 3 KB
  • references/terraform-usage.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · AkshatNaruka/aidentity100MIT
google/skills100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 1307d6e6246b (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-basics
    Pomaga zakładać instancje i tabele Bigtable, projektować schematy i klucze wierszy, pisać zapytania SQL i kod klienta w Java, Go lub Python oraz diagnozować hotspoty.
  • 100bigtable-basics
    Pomaga zakładać instancje i tabele Bigtable, projektować schematy i klucze wierszy, pisać zapytania SQL i kod klienta w Java, Go lub Python oraz diagnozować hotspoty.
  • 100bigtable-basics
    Pomaga zakładać instancje i tabele Bigtable, projektować wydajne schematy i klucze wierszy, pisać zapytania SQL lub kod klienta (Java, Go, Python) oraz diagnozować problemy z wydajnością i hotspotami.
  • 100bigtable-basics
    Projektuje instancje, tabele i klucze wierszy w Bigtable, pisze zapytania i kod klienta oraz diagnozuje gorące węzły.
  • 100gcp-cloud-sql
    Tworzy bazy Cloud SQL i Spanner w Google Cloud z wysoką dostępnością, kopiami zapasowymi i zabezpieczeniami.
  • 100gcp-cloud-sql
    Tworzy bazy Cloud SQL i Spanner w Google Cloud z wysoką dostępnością, kopiami zapasowymi i zabezpieczeniami.

Uwagi i zgłoszenia

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