İçeriğe geç
Aurabase Logosu
aura tabanı

Hızlı başlangıç

Sıfırdan sorgulanabilir bir API'ye: özel Postgres veritabanı, satır düzeyinde güvenlik, gerçek zamanlı ve TypeScript türü oluşturma dahil — kredi kartı gerekmez.

Eğitim5 dk. okuSeviye acemi21 Eki 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

Kodlama ajanınız için istem

Set up Aurabase in this app by following this page: https://aurabase.cloud/en/docs/getting-started.md

Documentation: read https://aurabase.cloud/llms.txt first. Every docs page is also available as Markdown: add .md to its URL, for example (the same works for every page): https://aurabase.cloud/en/docs/getting-started.md

Client: install @aurabase/aurabase-js and create the client with createClient(NEXT_PUBLIC_AURABASE_URL, NEXT_PUBLIC_AURABASE_ANON_KEY). Keep AURABASE_SERVICE_ROLE_KEY on the server: never put it in client code.

Project access: to read the schema and run SQL, start the Aurabase MCP server over stdio (82 tools with a project key):
npx -y -p @aurabase/mcp-server aurabase-mcp --url https://<slug>.aurabase.cloud --project-id <project-id> --service-role-key aura_sk_…
The project id is in Studio › Settings › General. The service role key is shown once when the project is created; regenerate it in Studio › Settings › Connection if you lost it.

Hızlı başlangıç#

SDK'yı yükleyin, istemciyi oluşturun ve ilk satırlarınızı okuyun.

1. SDK'yı yükleyin#

SDK'yı projenize ekleyin. Rust sekmesi aurabase kasasını yükler; cURL sekmesi proje URL'nizin yanıt verip vermediğini kontrol eder.

bash
pnpm add @aurabase/aurabase-js

2. İstemciyi oluşturun#

İstemciyi hem Studio › Ayarlar › Bağlantı'da proje URL'niz ve anon anahtarınızla oluşturun. Hizmet rolü anahtarını sunucuda tutun.

typescript
import { createClient } from '@aurabase/aurabase-js'

const aura = createClient(
  process.env.NEXT_PUBLIC_AURABASE_URL!,
  process.env.NEXT_PUBLIC_AURABASE_ANON_KEY!,
)

3. Veritabanını sorgulayın#

todos öğesinden en fazla 10 satırı okuyun. Tablo, aşağıdaki "Tablo oluştur" bölümünde oluşturulur; mevcut olana kadar error ayarlanmıştır.

typescript
// 'yapılacaklar' aşağıdaki "Tablo oluştur" bölümünde oluşturulur
const { data, error } = await aura
  .from('todos')
  .select('id, title, done')
  .limit(10)

console.log(data, error)

Önkoşullar#

Node.js ≥ 20'nin kurulu olduğunu ve bir POSIX terminalinin menzil içinde olduğunu varsayıyoruz. Yerel veritabanı gerekmez: Aurabase her proje için özel bir Postgres veritabanı sağlar.

Bilgi

Supabase veya Firebase'den mi geliyorsunuz? Çoğu kavram yer değiştirebilir. geçiş kılavuzuna bakın.

SDK'yı yükleme#

Resmi SDK, CRUD, kimlik doğrulama, gerçek zamanlı ve depolama için yazılan bir istemciyi kullanıma sunar. Next.js, React, Node, Bun veya Deno'de aynı şekilde çalışır.

terminalbash
# Önerilen
pnpm add @aurabase/aurabase-js

Paket adı @aurabase/ kapsamını içerir. Kapsamı olmayan aurabase-js paketi Aurabase tarafından korunmaz: kurmayın.

İpucu

SDK, otomatik oturum tanımlama bilgisi yönetimi ve kesilme önleyici yığınlama ile Next.js (Uygulama Yönlendiricisi, Sunucu Eylemleri, Ara Yazılım), Remix, Nuxt ve SvelteKit için doğrudan @aurabase/aurabase-js/ssr (createServerClient) dışa aktarımını içerir.

Proje oluştur#

Studio'dan bir proje oluşturun. Aktif hale geldiğinde, Studio bir Anahtarlarınızı şimdi kopyalayın panelini kullanıma hazır bir .env.local ile gösterir (kopyalayın veya indirin): service_role anahtarı orada görünür bir kez, daha sonra yalnızca karma değeri tutulur. Ayarlar › Bağlantı daha sonra proje URL'sini ve genel anonim anahtarını gösterir; service_role anahtarını kaybettiyseniz, orada yeniden oluşturun (önceki iptal edilir). NEXT_PUBLIC_AURABASE_URL ve NEXT_PUBLIC_AURABASE_ANON_KEY istemci tarafında yayınlanabilir; AURABASE_SERVICE_ROLE_KEY kesinlikle sunucu tarafında kalır.

.env.localbash
NEXT_PUBLIC_AURABASE_URL=https://<slug>.aurabase.cloud
NEXT_PUBLIC_AURABASE_ANON_KEY=aura_anon_…
AURABASE_SERVICE_ROLE_KEY=aura_sk_…
ŞemaErişimİçerir
project_{uuid}senUygulama tablolarınız
project_{uuid}_authSistemusers, sessions, oauth_accounts, mfa
project_{uuid}_storageSistembuckets, objects, rls_policies
project_{uuid}_platformSistemfunctions, jobs, cron_jobs, api_keys
Terminali mi tercih edersiniz?

Yolun tamamı CLI'den de çalışır (kurulum için bkz. CLI): aura projects create proje hazır olana kadar bekler ve URL'yi ve anahtarları bir kez yazdırır.

terminalbash
aura login
aura projects create todos-app --json > project.json    # proje aktif olana kadar bekler
aura link --project-id "$(jq -r .id project.json)"
export NEXT_PUBLIC_AURABASE_URL="$(jq -r .url project.json)"
export AURABASE_SERVICE_ROLE_KEY="$(jq -r .service_role_key project.json)"
aura db raw "create table todos (id bigint generated always as identity primary key, title text not null, done boolean not null default false, user_id uuid not null default auth.uid(), created_at timestamptz not null default now())"
aura db raw "create policy todos_own_read on todos for select to aura_authenticated using (auth.uid() = user_id)"
aura db raw "create policy todos_own_insert on todos for insert to aura_authenticated with check (auth.uid() = user_id)"
aura db table realtime todos on
aura db raw "select count(*) from todos" --as authenticated --user <a user id>   # o kullanıcının ne gördüğünü gör
Hizmet rolü anahtarı

Hiçbir zaman bir istemci paketine AURABASE_SERVICE_ROLE_KEY eklemeyin. Tüm RLS politikalarını atlar ve API bunu bir tarayıcıdan (401 SECRET_KEY_IN_BROWSER) reddeder. Bunu sunucu çağrıları (yönlendirme işleyicileri, sunucu eylemleri, işler) için ayırın.

Bir tablo oluştur#

Studio'da Veritabanı açın, SQL Düzenleyici (tablolar panelinin altındaki bağlantı) öğesine tıklayın ve bu betiği çalıştırın. Satır düzeyinde güvenlik her tabloda etkinleştirilir: ilk iki politika, oturum açan her kullanıcının kendi satırlarını okumasına ve oluşturmasına izin verir; üçüncüsü, ziyaretçilerin tabloyu okumasına olanak tanıyan ve böylece oturum açmadan ilk satırlarınızı görebilmenizi sağlayan bir örneği'dir. Politikalar aura_authenticated rolünü (ziyaretçiler için aura_anon) hedefler.

todos.sqlsql
create table todos (
  id bigint generated always as identity primary key,
  title text not null,
  done boolean not null default false,
  user_id uuid not null default auth.uid(),
  created_at timestamptz not null default now()
);
create policy "todos_own_read" on todos for select to aura_authenticated using (auth.uid() = user_id);
create policy "todos_own_insert" on todos for insert to aura_authenticated with check (auth.uid() = user_id);
-- Yalnızca örnek: herhangi bir ziyaretçi yapılacak her şeyi okuyabilir. Üretimden önce bırakın:
--   yapılacaklar listesine "todos_public_read" politikasını bırakın;
create policy "todos_public_read" on todos for select to aura_anon using (true);

Ardından şemanızın TypeScript türlerini oluşturun (komutta .env.local yazıyor):

terminalbash
npx @aurabase/gen --out lib/aurabase.types.ts

İlk çağrı#

Ortam değişkenlerinden anahtarları okuyarak yeniden kullanılabilir bir Aurabase istemcisi oluşturun ve ardından ilk tablonuzu sorgulayın. Aşağıdaki yollar uygulamanızın köküne göredir: Projeniz bir src/ dizini kullanıyorsa, lib/, components/ ve app/ dizinini içine koyun, böylece @/ içe aktarma takma adı çözümlenir.

lib/aurabase.tstypescript
import { createClient } from '@aurabase/aurabase-js'
import type { Database } from './aurabase.types'

export const aura = createClient<Database>(
  process.env.NEXT_PUBLIC_AURABASE_URL!,
  process.env.NEXT_PUBLIC_AURABASE_ANON_KEY!,
)

Daha sonra bir rota işleyicisinde veya bir sunucu bileşeninde:

app/api/todos/route.tstypescript
import { aura } from '@/lib/aurabase'

export async function GET() {
  const { data, error } = await aura
    .from('todos')
    .select('id, title, done')
    .order('created_at', { ascending: false })
    .limit(10)

  if (error) throw error
  return Response.json(data)
}
İpucu

Bu, todos_public_read örnek politikası sayesinde, oturum açmış bir kullanıcı da dahil olmak üzere tablonun satırlarını döndürür. Bu olmadan (üretimden önce yapmanız gerektiği gibi bıraktığınızda) bir ziyaretçi [] alır: diğer politikalar yalnızca aura_authenticated satırlarını açar, bu nedenle ilk önce aura.auth.signInWithPassword({ email, password }) ile oturum açın (bkz. Next.js için hazır oturum açma sayfaları). Her şema değişikliğinden sonra Database türlerini npx @aurabase/gen ile yeniden oluşturun.

İlk satırı eklemek için bir kullanıcıyı kaydedin ve giriş yapın, ardından ekleyin. user_id sütunu varsayılan olarak auth.uid() şeklindedir:

scripts/first-row.tstypescript
import { aura } from '../lib/aurabase'

async function main() {
  const email = 'you@example.com'
  const password = 'a-strong-password'

  await aura.auth.signUp({ email, password })
  await aura.auth.signInWithPassword({ email, password })

  const { data, error } = await aura.from('todos').insert({ title: 'First todo' }).select()
  console.log(data, error)
}

main().catch((err) => {
  console.error(err)
  process.exit(1)
})

Uzantısız içe aktarmayı çözen ve .env.local yazan tsx ile çalıştırın:

terminalbash
pnpm add -D tsx
pnpm approve-builds   # pnpm 10+: esbuild'in kurulum komut dosyasına izin verin, ardından şunu çalıştırın:
pnpm exec tsx --env-file=.env.local scripts/first-row.ts
npm 11 esbuild'in kurulum komut dosyasını bloklar

Npm 11 veya üzeri sürümlerde, npx tsx "Esbuild'i başka bir platform için yüklediniz" hatasıyla başarısız olur çünkü esbuild'in yükleme komut dosyası varsayılan olarak engellenmiştir. Yukarıdaki gibi pnpm kullanın veya tsx atlayın ve iki içe aktarmayı uzantılarıyla ('../lib/aurabase.ts', './aurabase.types.ts'): node --env-file=.env.local --experimental-strip-types scripts/first-row.ts yazdıktan sonra komut dosyasını Node'un yerleşik tür sıyırma (Node 22.6+) ile çalıştırın.

E-posta onayı varsayılan olarak kapalıdır

Projenizin kullanıcıları için, signUp ve ardından signInWithPassword hemen çalışır: e-posta onayı, Studio › Kimlik Doğrulama › Yapılandırma'da açılana kadar kapalıdır (bir posta sunucusuna ihtiyaç duyar). Daha sonra herkes herhangi bir adresle kaydolabilir; bu nedenle üretimden önce açın.

Dikkat

service_role anahtarının oturum açmış kullanıcısı yok, bu nedenle auth.uid() NULL'dir ve varsayılana dayanan bir ekleme NOT_NULL_VIOLATION ile başarısız olur. Bir sunucudan user_id komutunu açıkça iletin.

Gerçek zamanlı bağlanın#

Otomatik anlaşmalı üç aktarım: WebSocket, SSE, NATS. Müşteri, ağa bağlı olarak en iyi olanı seçer; yapılandırma gerekmez.

CLI ile tabloda gerçek zamanı bir kez etkinleştirin:

terminalbash
aura db table realtime todos on

veya HTTP API ile bir sunucudan (.env.local değerinden gelen değerler):

terminalbash
curl -X PUT "$NEXT_PUBLIC_AURABASE_URL/v1/db/schema/tables/todos/realtime" \
  -H "apikey: $AURABASE_SERVICE_ROLE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

Daha sonra değişikliklere abone olun. Oturum açmış bir kullanıcı, kanalın oturum açmadan önce ne zaman açıldığı da dahil olmak üzere, RLS politikalarının okumasına izin verdiği satırları alır (otomatik olarak yeniden kimlik doğrulaması yapılır); Reddedilen bir abonelik, nedeni ile birlikte CHANNEL_ERROR raporunu verir.

components/LiveTodos.tsxtypescript
'use client'
import { aura } from '@/lib/aurabase'
import { useEffect } from 'react'

export function LiveTodos() {
  useEffect(() => {
    const channel = aura.realtime
      .channel('todos')
      .on('postgres_changes', { event: '*', schema: 'public', table: 'todos' }, (change) =>
        console.log(change.eventType, change.new),
      )
      .subscribe((status, err) => {
        // Geliştirme aşamasında React StrictMode bileşeni bağlar, bağlantısını kaldırır ve yeniden bağlar:
        // İlk KAPALI bu temizlikten geliyor ve bekleniyor.
        if (status === 'SUBSCRIBED') console.log('realtime connected')
        if (status === 'CHANNEL_ERROR') console.error('realtime refused:', err?.message)
      })

    return () => {
      void channel.unsubscribe()
    }
  }, [])
  return null
}
İpucu

Abonelikler tek bir TCP bağlantısı üzerinden çoğaltılır. İhtiyaç duyduğunuz kadar açın; sıfır ek ağ maliyeti.

Daha ileri gitmek için#