FaunaDB环境搭建 #

注册流程：
├── 1. 访问 https://fauna.com
├── 2. 点击 "Start Free"
├── 3. 填写注册信息
├── 4. 验证邮箱
└── 5. 登录Dashboard

Dashboard功能：
├── 数据库管理
├── 集合管理
├── 索引管理
├── Shell终端
├── GraphQL Playground
├── 密钥管理
└── 监控面板

创建步骤：
├── 1. 登录Dashboard
├── 2. 点击 "Create Database"
├── 3. 输入数据库名称
├── 4. 选择区域（可选）
├── 5. 点击 "Create"
└── 数据库创建完成

// 创建数据库
CreateDatabase({
  name: "my_database"
})

// 创建子数据库
CreateDatabase({
  name: "child_database"
}, {
  parent: Database("parent_database")
})

创建步骤：
├── 1. 选择数据库
├── 2. 进入 "Security" 选项卡
├── 3. 点击 "New Key"
├── 4. 选择角色
├── 5. 可选：设置过期时间
├── 6. 点击 "Save"
└── 7. 复制密钥（只显示一次）

// 创建Admin密钥
CreateKey({
  role: "admin"
})

// 创建Server密钥
CreateKey({
  role: "server",
  database: Database("my_database")
})

// 创建自定义角色密钥
CreateKey({
  role: Role("custom_role"),
  database: Database("my_database")
})

安全建议：
├── 不要在客户端暴露Server密钥
├── 使用环境变量存储密钥
├── 定期轮换密钥
├── 为不同环境使用不同密钥
└── 删除不再使用的密钥

# 使用Homebrew
brew install fauna-shell

# 或使用npm
npm install -g fauna-shell

# 使用npm
npm install -g fauna-shell

# 或使用Chocolatey
choco install fauna-shell

# 使用npm
npm install -g fauna-shell

# 或下载二进制文件
curl https://github.com/fauna/fauna-shell/releases/latest/download/fauna-shell-linux -o fauna
chmod +x fauna
sudo mv fauna /usr/local/bin/

# 查看版本
fauna --version

# 查看帮助
fauna --help

# 添加云端点
fauna add-endpoint https://db.fauna.com

# 添加区域端点
fauna add-endpoint https://db.us.fauna.com
fauna add-endpoint https://db.eu.fauna.com

# 交互式配置
fauna cloud-login

# 或手动配置
# 创建 ~/.fauna-shell 配置文件

{
  "default": "cloud",
  "endpoints": {
    "cloud": {
      "domain": "db.fauna.com",
      "scheme": "https",
      "secret": "your-secret-key"
    },
    "us-region": {
      "domain": "db.us.fauna.com",
      "scheme": "https",
      "secret": "your-us-secret-key"
    }
  }
}

# 设置密钥环境变量
export FAUNA_SECRET="your-secret-key"

# 设置端点
export FAUNA_DOMAIN="db.fauna.com"
export FAUNA_SCHEME="https"
export FAUNA_PORT="443"

# 创建数据库
fauna create-database my_database

# 列出数据库
fauna list-databases

# 删除数据库
fauna delete-database my_database

# 创建集合
fauna create-collection my_collection

# 列出集合
fauna list-collections

# 删除集合
fauna delete-collection my_collection

# 进入Shell
fauna shell my_database

# 执行脚本文件
fauna eval my_database --file=query.fql

# 执行内联查询
fauna eval my_database 'Paginate(Collections())'

# 导出数据
fauna export my_database --output=./backup

# 导入数据
fauna import my_database --file=./data.json

# 安装驱动
npm install fauna

# 或使用yarn
yarn add fauna

const { Client, query } = require('fauna');
const client = new Client({
  secret: process.env.FAUNA_SECRET,
});

// 或使用ES模块
import { Client, query } from 'fauna';

# 安装驱动
pip install fauna

# 或使用poetry
poetry add fauna

from fauna import fql
from fauna.client import FaunaClient

client = FaunaClient(secret='your-secret-key')

# 安装驱动
go get github.com/fauna/fauna-go

package main

import (
    "github.com/fauna/fauna-go"
)

func main() {
    client := fauna.NewFaunaClient("your-secret-key")
}

<dependency>
    <groupId>com.faunadb</groupId>
    <artifactId>faunadb-java</artifactId>
    <version>4.2.0</version>
</dependency>

implementation 'com.faunadb:faunadb-java:4.2.0'

# 创建项目目录
mkdir fauna-project
cd fauna-project

# 初始化Node.js项目
npm init -y

# 安装Fauna驱动
npm install fauna

# 创建环境变量文件
echo "FAUNA_SECRET=your-secret-key" > .env

fauna-project/
├── src/
│   ├── index.js
│   ├── db.js
│   └── queries/
│       └── user.fql
├── .env
├── .gitignore
└── package.json

// db.js
const { Client, query } = require('fauna');

const client = new Client({
  secret: process.env.FAUNA_SECRET,
});

module.exports = { client, q: query };

// index.js
require('dotenv').config();
const { client, q } = require('./db');

async function main() {
  try {
    // 创建集合
    await client.query(
      q.CreateCollection({ name: 'users' })
    );
    console.log('Collection created');

    // 创建文档
    const result = await client.query(
      q.Create(q.Collection('users'), {
        data: { name: 'Tom', email: 'tom@example.com' }
      })
    );
    console.log('Document created:', result);
  } catch (error) {
    console.error('Error:', error);
  }
}

main();

# 进入Shell
fauna shell my_database

# 使用特定端点
fauna shell my_database --endpoint us-region

// 创建集合
CreateCollection({ name: "products" })

// 创建索引
CreateIndex({
  name: "products_by_name",
  source: Collection("products"),
  terms: [{ field: ["data", "name"] }]
})

// 插入数据
Create(Collection("products"), {
  data: { name: "iPhone", price: 999 }
})

// 查询数据
Get(Ref(Collection("products"), "123456"))

// 退出Shell
.exit

启用步骤：
├── 1. 进入数据库Dashboard
├── 2. 点击 "GraphQL" 选项卡
├── 3. 上传Schema文件
└── GraphQL API启用完成

type User {
  name: String!
  email: String! @unique
  age: Int
  posts: [Post!] @relation
}

type Post {
  title: String!
  content: String
  author: User! @relation
}

type Query {
  allUsers: [User!]!
  findUserByEmail(email: String!): User
}

GraphQL端点格式：
https://graphql.fauna.com/graphql

请求头：
Authorization: Bearer your-secret-key

推荐配置：
├── 开发环境
│   └── dev_database
├── 测试环境
│   └── test_database
└── 生产环境
    └── prod_database

// 使用环境变量
const client = new Client({
  secret: process.env.FAUNA_SECRET,
  domain: process.env.FAUNA_DOMAIN || 'db.fauna.com',
});

// 不同环境配置
const config = {
  development: {
    secret: process.env.FAUNA_DEV_SECRET,
  },
  production: {
    secret: process.env.FAUNA_PROD_SECRET,
  }
};

const { Client, query, errors } = require('fauna');

async function safeQuery(queryFn) {
  try {
    return await client.query(queryFn);
  } catch (error) {
    if (error instanceof errors.FaunaHTTPError) {
      console.error('Fauna Error:', error.message);
      console.error('Description:', error.description);
    }
    throw error;
  }
}

问题：无法连接到Fauna
解决方案：
├── 检查网络连接
├── 验证密钥是否正确
├── 确认端点配置
└── 检查防火墙设置

问题：权限不足错误
解决方案：
├── 检查密钥角色
├── 确认数据库访问权限
├── 验证自定义角色配置
└── 检查资源权限设置

问题：延迟过高
解决方案：
├── 选择就近区域
├── 使用区域端点
├── 配置区域复制
└── 优化查询性能