Aurabase-Logo
AurabasisDokumente
Dokumente›Edge Functions›Your first function

Ihre erste Edge-Funktion

Sie schreiben eine Funktion, stellen sie in Ihrem Projekt bereit, rufen sie über Node.js auf und lesen das Ergebnis. Jeder folgende Befehl wurde tatsächlich ausgeführt.

10 Min. gelesen·Ebene Anfänger·Überarbeitet am 12.10.2026
Dieser englische Text wurde automatisch aus dem französischen Original generiert und wurde noch nicht überprüft.
Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.
#
Anforderungen

Bevor Sie beginnen

Sie benötigen:

  • Node.js 20 oder höher.
  • Die aura-CLI. Installieren Sie es mit npm install -g @aurabase/cli (siehe CLI-Referenz für andere Plattformen).
  • Ein Aurabase-Konto.
Das CLI spricht heute Französisch

Die aura CLI druckt ihre Nachrichten auf Französisch. Die folgenden Ausgaben sind aus realen Läufen kopiert und nicht übersetzt.

#
Projekt

1. Erstellen und verknüpfen Sie ein Projekt

Melden Sie sich an, erstellen Sie ein Projekt und verknüpfen Sie Ihren Arbeitsordner damit. Ersetzen Sie <org-slug> durch den von aura orgs list angezeigten Slug.

terminalbash
aura login --email you@example.com --password '<your-password>'
aura orgs list
aura projects create my-app --org <org-slug>

Der letzte Befehl gibt die Projekt-URL und Ihre ersten API-Schlüssel aus. Kopieren Sie sie jetzt: Die Anfangsschlüssel werden nur einmal angezeigt. Wenn Sie sie vermissen, erstellen Sie im Studio unter Einstellungen, API-Schlüssel neue.

outputtext
  ✔ Projet créé : my-app (e99f2c4f-43e2-4d08-b023-b4f9e687d17c)
    import { createClient } from '@aurabase/aurabase-js'
    const client = createClient('http://my-app-ajap5iw2.localhost:8080', 'aura_anon_…')

Verknüpfen Sie den aktuellen Ordner mit dem Projekt:

terminalbash
aura link --project-id e99f2c4f-43e2-4d08-b023-b4f9e687d17c
outputtext
  ✔ Projet e99f2c4f-… lié dans aurabase.toml.
  • URL du projet : http://my-app-ajap5iw2.localhost:8080

Teilen Sie der CLI dann mit, wo sich die Datenebene befindet und welcher Schlüssel verwendet werden soll. Für die Bereitstellung ist ein service_role-Schlüssel erforderlich, da die Bereitstellung von Code eine administrative Aktion ist.

.envbash
AURA_PROJECT_URL=http://my-app-ajap5iw2.localhost:8080
AURA_API_KEY=<your service_role key>
Behalten Sie den service_role-Schlüssel auf Ihrem Computer

Ein service_role-Schlüssel umgeht die Sicherheit auf Zeilenebene und kann Code bereitstellen. Fügen Sie es niemals in ein Browser-Bundle ein oder schreiben Sie .env fest.

#
Code

2. Schreiben Sie die Funktion

terminalbash
aura functions new hello
outputtext
  ✔ Nouvelle fonction créée dans aurabase/functions/hello (gabarit TypeScript Deno)

Öffnen Sie aurabase/functions/hello/index.ts und ersetzen Sie den Inhalt:

aurabase/functions/hello/index.tstypescript
Deno.serve(async (req: Request) => {
  const { name = 'world' } = await req.json().catch(() => ({}))

  return new Response(JSON.stringify({ greeting: `Hello, ${name}!` }), {
    headers: { 'content-type': 'application/json' },
  })
})

Eine Funktion muss Deno.serve aufrufen. Ein export default wird nie aufgerufen.

#
Bereitstellen

3. Stellen Sie es bereit

terminalbash
aura functions deploy hello
outputtext
  ✔ Détection script TypeScript (runtime: deno)...
  • Envoi vers le service (runtime: deno)...
✔ Fonction 'hello' déployée avec succès !

Rufen Sie es einmal über die CLI auf, um zu überprüfen, ob es antwortet:

terminalbash
aura functions invoke hello --data '{"name":"Ada"}'
outputtext
  ✔ Réponse (200) :
{
  "data": {
    "body": { "greeting": "Hello, Ada!" },
    "duration_ms": 74,
    …
#
SDK

4. Rufen Sie es über das SDK auf

terminalbash
mkdir hello-client && cd hello-client
npm init -y
npm install @aurabase/aurabase-js
hello.mjstypescript
import { createClient } from '@aurabase/aurabase-js'

const aura = createClient(process.env.AURA_PROJECT_URL, process.env.AURA_ANON_KEY)

const { data, error } = await aura.functions.invoke('hello', { body: { name: 'Ada' } })
if (error) throw error

console.log(data.greeting)
terminalbash
AURA_PROJECT_URL=http://my-app-ajap5iw2.localhost:8080 AURA_ANON_KEY=aura_anon_… node hello.mjs
outputtext
Hello, Ada!

Sie haben eine Funktion mit dem öffentlichen Schlüssel anon aufgerufen. Das ist der einzige Aufruf, den ein öffentlicher Schlüssel durchführen kann: Sehen Sie sich an, wer was aufrufen kann.

Zuletzt aktualisiert · 12.10.2026