# Stripe Database

Stripe がホストする Postgres データベースに接続し、すぐにデータにアクセスできます。

Stripe Database は、Stripe がホストする読み取り専用の Postgres データベースです。任意の標準的な Postgres クライアントを使用して接続でき、お客様の現在の Stripe データに SQL で直接アクセスして 1 秒未満の低遅延でデータを問い合わせることができます。お客様側でのインフラ管理はありません。Stripe アカウントの分析に利用したり、Stripe データベース上でアプリケーションを直接構築することも可能です。

> 標準的な Postgres クライアントを使用してデータにアクセスする方法の例を次に示します。

```sql
psql "postgres://{id}.db.stripe.com/{id}"
select * from customers;
```

## 取得可能なデータ

Stripe Database には、公開されている Stripe API のうち、リストエンドポイントに対応しているすべてのデータが格納されています。つまり:

- 一覧取得できるすべてのリソース (支払い、顧客、サブスクリプション、支払いインテント、請求書など) は取得可能です。
- 一覧ではなく単一のオブジェクトを返すリソースは使用できません。例として、[残高](https://docs.stripe.com/api/balance.md)は単一のオブジェクトであるため、本データベースとの同期対象ではありません。
- 公開 API 以外のデータは使用できません。財務レポートやその他の派生データセットは対象外です。

どのテーブルを同期するかはお客様側で制御できます。各テーブルごとに、同期の有効化・無効化をいつでも切り替え可能です。

### API バージョン

作成するデータベースはすべて、アカウントの現在の API バージョンを使用します。作成後も、データベースはその API バージョンのまま維持されます。

より新しいバージョンの API に更新する場合、Stripe は新しいバージョン用にまったく新しい別のデータベースを新規作成します。既存のデータベースは変更されません。

## アクセスをリクエストする  (プライベートベータ版)

Stripe Databaseは現在、プライベートプレビュー段階です。以下に登録してアクセスをリクエストしてください。