# GCP Billing 数据分析报告

## 概述

本文档记录了 `gcp-digital-bi.gcp_billing_v2.gcp_billing_export_v1_01A169_D3D9BF_FB82A2` 表的基础数据信息，为后续开发监控分析程序提供数据基础。

## 1. 数据集基本信息

- **数据集**: `gcp-digital-bi.gcp_billing_v2`
- **主表**: `gcp_billing_export_v1_01A169_D3D9BF_FB82A2`
- **表类型**: TABLE (日分区)
- **项目总数**: 76个GCP项目
- **记录总数**: 280,485,065条
- **数据时间范围**: 2023-04-17 ~ 2025-08-14
- **最新数据**: 2025-08-14

## 2. 数据表结构

### 2.1 核心字段

```sql
-- 基本计费信息
billing_account_id                 -- 账单账户ID
cost                              -- 成本金额 ⭐ 主要成本字段
currency                          -- 货币代码
usage_start_time                  -- 使用开始时间 ⭐ 主要时间字段
usage_end_time                    -- 使用结束时间

-- 项目信息 (RECORD结构)
project.id                        -- 项目ID ⭐ 项目标识
project.name                      -- 项目名称
project.number                    -- 项目编号
project.labels                    -- 项目标签 (REPEATED)

-- 服务信息 (RECORD结构)
service.id                        -- 服务ID
service.description               -- 服务描述 ⭐ 服务分类

-- SKU信息 (RECORD结构)
sku.id                           -- SKU ID
sku.description                  -- SKU描述 ⭐ 资源类型

-- 地理位置 (RECORD结构)
location.location                 -- 位置
location.region                   -- 区域
location.zone                     -- 可用区

-- 使用量 (RECORD结构)
usage.amount                      -- 使用量
usage.unit                        -- 使用量单位

-- 标签 (REPEATED RECORD结构)
labels[].key                      -- 用户标签键
labels[].value                    -- 用户标签值
tags[].key                        -- 标签键
tags[].value                      -- 标签值

-- 抵扣 (REPEATED RECORD结构)
credits[].name                    -- 抵扣名称
credits[].amount                  -- 抵扣金额
credits[].type                    -- 抵扣类型
```

## 3. 查询注意事项

### 3.1 数据结构特点
- **嵌套RECORD**: 多个字段为RECORD类型，需要使用点号访问
- **REPEATED字段**: labels、tags、credits为REPEATED类型，查询时需要UNNEST
- **NULL值处理**: 部分项目信息可能为NULL

### 3.2 基础查询模式

#### 项目成本查询
```sql
SELECT 
  project.id,
  project.name,
  DATE(usage_start_time) as date,
  SUM(cost) as daily_cost
FROM `gcp-digital-bi.gcp_billing_v2.gcp_billing_export_v1_01A169_D3D9BF_FB82A2`
WHERE project.id IS NOT NULL
GROUP BY project.id, project.name, DATE(usage_start_time)
```

#### 服务成本查询
```sql
SELECT 
  service.description as service_name,
  SUM(cost) as total_cost
FROM `gcp-digital-bi.gcp_billing_v2.gcp_billing_export_v1_01A169_D3D9BF_FB82A2`
GROUP BY service.description
```

#### 标签查询 (需要UNNEST)
```sql
SELECT 
  tag.key,
  tag.value,
  SUM(cost) as tagged_cost
FROM `gcp-digital-bi.gcp_billing_v2.gcp_billing_export_v1_01A169_D3D9BF_FB82A2`
CROSS JOIN UNNEST(tags) as tag
WHERE tag.key IS NOT NULL
GROUP BY tag.key, tag.value
```

## 4. 数据质量状况

- **时效性**: 数据更新至2025-08-14
- **完整性**: 2025年4月1日后数据完整
- **项目覆盖**: 76个项目，包含生产和非生产环境
- **数据连续性**: 从2023年4月开始有连续数据

## 5. 关键监控字段

| 字段类型 | 字段名 | 用途 | 数据类型 |
|---------|--------|------|----------|
| 时间维度 | usage_start_time | 主要时间字段 | TIMESTAMP |
| 成本维度 | cost | 主要成本字段 | FLOAT |
| 项目维度 | project.id | 项目识别 | STRING |
| 服务维度 | service.description | 服务分类 | STRING |
| 地域维度 | location.region | 地域分析 | STRING |
| 标签维度 | tags[].key/value | 成本分摊 | REPEATED |

---

*数据截止: 2025-08-14*