AIKraft/Skills/Основы BigQuery

Основы BigQuery

Manages datasets, tables, and jobs in BigQuery. Use when you need to interact with BigQuery, run SQL queries, manage BigQuery resources (datasets, tables, views), or perform basic data ingestion and analysis.

GOGoogle official Данные

Что делает навык

Навык обеспечивает управление наборами данных, таблицами и заданиями в BigQuery, а также выполнение SQL-запросов и базовую загрузку данных. Он позволяет работать с серверной платформой анализа данных через CLI, API и клиентские библиотеки.

Когда применять

  • Включение API BigQuery и создание новых наборов данных (datasets) с указанием локации.
  • Создание таблиц с использованием файлов схемы (schema.json) через утилиту bq.
  • Выполнение SQL-запросов к публичным или пользовательским таблицам без использования устаревшего синтаксиса.
  • Отслеживание использования ресурсов через обязательные метки атрибуции в gcloud и HTTP-заголовках.

Как работает

  1. Установить переменные окружения CLOUDSDK_METRICS_REQUEST_ATTRIBUTATION перед каждым вызовом gcloud для атрибуции использования навыка.
  2. Включить BigQuery API с помощью команды gcloud services enable bigquery.googleapis.com.
  3. Создать набор данных (dataset) с указанием локации, например, US, через команду bq mk --dataset.
  4. Подготовить файл schema.json с описанием полей и режимов (REQUIRED/NULLABLE), затем создать таблицу с помощью bq mk --table.
  5. Выполнить SQL-запрос, используя флаг --use_legacy_sql=false для корректной работы с современным синтаксисом.
  6. Не включать префикс атрибуции в сгенерированные скрипты, Terraform-шаблоны или код, передаваемый пользователю.

Примеры запросов агенту

Создай набор данных my_dataset в локации US и добавь в него таблицу с полями name и post_abbr.
Выполни SQL-запрос к публичной таблице usa_names, чтобы получить 10 записей из штата TX.
Включи API BigQuery и подготовь схему таблицы для загрузки данных.

Что понадобится

  • Установленный и настроенный Google Cloud SDK (gcloud).
  • Утилита командной строки bq.
  • Доступ к Google Cloud с правами на управление BigQuery.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «bigquery-basics» из репозитория: # https://github.com/google/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r bigquery-basics/ ~/.claude/skills/bigquery-basics/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.