JavaScript SDK'sı: veritabanı referansı
aura.db ve zincirlenebilir sorgu oluşturucunun her yöntemi, imzasıyla birlikte.
6 dk. oku·Seviye referans·12 Eki 2026 tarihinde revize edildi
Bu İngilizce metin, Fransızca orijinalinden otomatik olarak oluşturulmuştur ve henüz incelenmemiştir.
Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.
#
Sınıf
Veritabanı Hizmeti
| Yöntem | Açıklama |
|---|---|
from<TableName extends string & keyof Schema['Tables'], Table extends Schema['Tables'][TableName]>(table: TableName): AuraQueryBuilder<Schema, Table, TableName, AuraClientOptionsT>from<ViewName extends string & keyof Schema['Views'], View extends Schema['Views'][ViewName]>(view: ViewName): AuraQueryBuilder<Schema, View, ViewName, AuraClientOptionsT>from(table: string): AuraQueryBuilder<any, any, any, AuraClientOptionsT> | Bir tabloda bir sorgu başlatın. |
sql<T = unknown>(query: string, params?: unknown[], options?: RawSqlOptions): Promise<AuraResponse<T>> | Ham bir SQL sorgusu yürütür (POST /v1/db/raw). |
rpc<FnName extends string, Args extends RpcArgsFor<Schema, FnName> = RpcArgsFor<Schema, FnName>, Fn extends { Row: Record<string, unknown>; Result: unknown; RelationName: unknown; Relationships: unknown; } = RpcResultFor<Schema, FnName, Args>>(fn: FnName, args?: Args, options?: RpcOptions): AuraFilterBuilder<Schema, Fn['Row'], Fn['RelationName'], Fn['Relationships'], Fn['Result'], AuraClientOptionsT> | PostgREST (POST|GET|HEAD /rpc/{fn}) tarafından sunulan Postgres işlevini çağırır. |
schema(): Promise<AuraResponse<{ tables: SchemaTable[]; functions: SchemaFunction[]; enums: SchemaEnum[]; views: SchemaTable[]; }>> | Geçerli proje için şemayı (tablolar ve sütunlar, PostgREST aracılığıyla kullanıma sunulan Postgres işlevleri, numaralandırma türleri ve görünümler) getirin. |
listFunctions(): Promise<AuraResponse<PgFunctionInfo[]>> | Proje şemasının işlevlerini listeler (GET /v1/db/functions). |
createFunction(definition: CreatePgFunctionRequest): Promise<AuraResponse<null>> | Bir Postgres (POST /v1/db/functions) işlevini oluşturur veya değiştirir. Bir service_role anahtarı gerektirir. Yalnızca PostgreSQL projeleri. |
dropFunction(name: string): Promise<AuraResponse<null>> | Proje şemasından bir özelliği kaldırır (DELETE /v1/db/functions/{name}). Bir service_role anahtarı gerektirir. |
listTriggers(table: PgRelationName<Schema>): Promise<AuraResponse<PgTriggerInfo[]>> | Bir tablonun tetikleyicilerini listeler (GET /v1/db/{table}/triggers). |
createTrigger(table: PgRelationName<Schema>, definition: CreatePgTriggerRequest): Promise<AuraResponse<null>> | Tabloda bir tetikleyici oluşturur (POST /v1/db/{table}/triggers). Bir service_role anahtarı gerektirir. Yalnızca PostgreSQL projeleri. |
dropTrigger(table: PgRelationName<Schema>, name: string): Promise<AuraResponse<null>> | Bir tablodan tetikleyiciyi kaldırır (DELETE /v1/db/{table}/triggers/{name}). service_role gerektirir. |
#
Sınıf
AuraQueryBuilder
Arka ucun QueryOptions / FilterOp biçimiyle eşleşen URL sorgu parametrelerini derleyen zincirlenebilir sorgu oluşturucu.
| Yöntem | Açıklama |
|---|---|
insert(body: Relation extends { Insert: infer I; } ? I | I[] : never): this | Bir satır veya satır dizisi ekler. |
update(id: string, body: Relation extends { Update: infer U; } ? U : never): AuraFilterBuilder<Schema, Relation['Row'], RelationName, Relation['Relationships'], Relation['Row'][], ClientOptions, false>update(body: Relation extends { Update: infer U; } ? U : never): AuraFilterBuilder<Schema, Relation['Row'], RelationName, Relation['Relationships'], Relation['Row'][], ClientOptions, false> | Satırları günceller: Filtreler tarafından hedeflenen update(body) veya tanımlayıcı başına bir satır için update(id, body). |
delete(id?: string): AuraFilterBuilder<Schema, Relation['Row'], RelationName, Relation['Relationships'], Relation['Row'][], ClientOptions, false> | Satırları siler: filtrelerle hedeflenir veya delete(id) ile tanımlayıcıya göre bir satır. |
upsert(body: Relation extends { Insert: infer I; } ? I | I[] : never, options?: { onConflict?: string; }): AuraFilterBuilder<Schema, Relation['Row'], RelationName, Relation['Relationships'], Relation['Row'][], ClientOptions, false> | Bir satırı veya satır dizisini ekler veya günceller (yukarı çıkarır). options.onConflict çakışma sütununu adlandırır (varsayılan olarak id). |
#
Sınıf
AuraFilterBuilder
Tüm PostgREST filtreleri (eq, neq, ... ilikeAnyOf).
| Yöntem | Açıklama |
|---|---|
eq<C extends keyof Row & string>(column: C, value: Row[C]): this | column öğesinin value değerine eşit olduğu satırları filtreler. |
neq<C extends keyof Row & string>(column: C, value: Row[C]): this | column öğesinin value öğesinden farklı olduğu satırları filtreler. |
gt<C extends keyof Row & string>(column: C, value: Row[C]): this | column öğesinin value değerinden kesinlikle büyük olduğu satırları filtreler. |
gte<C extends keyof Row & string>(column: C, value: Row[C]): this | column öğesinin value değerinden büyük veya ona eşit olduğu satırları filtreler. |
lt<C extends keyof Row & string>(column: C, value: Row[C]): this | column öğesinin value öğesinden kesinlikle küçük olduğu satırları filtreler. |
lte<C extends keyof Row & string>(column: C, value: Row[C]): this | column öğesinin value değerinden küçük veya ona eşit olduğu satırları filtreler. |
like(column: keyof Row & string, pattern: string): this | Desene göre filtrele LIKE, büyük/küçük harfe duyarlıdır (% bir karakter dizisinin yerini alır). |
ilike(column: keyof Row & string, pattern: string): this | Desene göre filtrele ILIKE, büyük/küçük harfe duyarlı değildir. |
is(column: keyof Row & string, value: 'null' | 'true' | 'false' | 'unknown' | 'not.null'): this | IS NULL veya IS NOT NULL filtresi. |
in<C extends keyof Row & string>(column: C, values: Row[C][]): this | column değeri values öğesinden biri olan satırları filtreler. |
or(filters: Array<{ column: string; op: string; value: unknown; }>): this | VEYA grubu ekleyin: or=(col1.eq.val1,col2.gt.val2) |
notIn<C extends keyof Row & string>(column: C, values: Row[C][]): this | column öğesinin values öğesinden herhangi birine eşit olmadığı satırları filtreler. |
contains(column: keyof Row & string, value: unknown): this | Sütunu (tablo, JSON veya aralık) value (operatör @>) içeren satırları filtreler. |
containedBy(column: keyof Row & string, value: unknown): this | Sütunu (dizi, JSON veya aralık) value (operatör <@) içinde yer alan satırları filtreler. |
overlaps(column: keyof Row & string, value: unknown): this | Sütunu (dizi veya aralık) value (operatör &&) ile ortak en az bir öğeye sahip olan satırları filtreler. |
rangeGt(column: keyof Row & string, range: string): this | Aralık: range (operatörü >>)'nin tam olarak sağında bulunan aralıkları filtreler. |
rangeGte(column: keyof Row & string, range: string): this | Aralık: range (operatörü &>) soluna doğru uzanmayan aralıkları filtreler. |
rangeLt(column: keyof Row & string, range: string): this | Aralık: range (operatörü <<)'nin tam solunda bulunan filtre aralıkları. |
rangeLte(column: keyof Row & string, range: string): this | Aralık: range (operatörü &<) sağına doğru uzanmayan aralıkları filtreler. |
rangeAdjacent(column: keyof Row & string, range: string): this | Aralık: range (operatör -|-)'e bitişik aralıkları filtreler. |
isDistinct(column: keyof Row & string, value: unknown): this | column öğesinin value öğesinden farklı olduğu satırları filtreler ve NULL değerini bir değer (IS DISTINCT FROM) olarak kabul eder. |
not(column: string, op: string, value: unknown): this | Bir filtreyi olumsuzlar: not('status', 'eq', 'done'), done'den farklı olan status ile eşdeğerdir. |
filter(column: string, op: string, value: unknown): this | Özel bir yöntemin kapsamına girmeyen durumlar için ham PostgREST operatörünü (eq, gt, cs…) içeren bir filtre ekler. |
match(query: Record<string, unknown>): this | Aynı anda birden fazla sütunda eşitliğe göre filtreleyin: match({ a: 1, b: 2 }). |
textSearch(column: keyof Row & string, query: string, options?: { type?: 'plain' | 'phrase' | 'websearch'; config?: string; }): this | Tam metin araması. options.type sorguyu seçer: 'plain', 'phrase' veya 'websearch' (aksi takdirde yerel tsquery sözdizimi); options.config dil yapılandırmasını ayarlar. |
likeAllOf(column: keyof Row & string, patterns: string[]): this | Filtre LIKE: sütun TÜM kalıplarla eşleşmelidir. |
likeAnyOf(column: keyof Row & string, patterns: string[]): this | Filtre LIKE: sütun, kalıplardan EN AZ BİRİ ile eşleşmelidir. |
ilikeAllOf(column: keyof Row & string, patterns: string[]): this | Filtre ILIKE (büyük/küçük harfe duyarlı değil): sütunun TÜM kalıplarla eşleşmesi gerekir. |
ilikeAnyOf(column: keyof Row & string, patterns: string[]): this | Filtre ILIKE (büyük/küçük harfe duyarlı değil): sütun, kalıplardan EN AZ BİRİ ile eşleşmelidir. |
#
Sınıf
AuraTransformBuilder
Sütun seçimi, sıralama, sayfalandırma ve önem değiştiricileri (single/maybeSingle/count).
| Yöntem | Açıklama |
|---|---|
select<Query extends string = '*', NewResultOne = GetResult<Schema, Row, RelationName, Relationships, Query, ClientOptions>>(columns?: Query, options?: SelectOptions): AuraFilterBuilder<Schema, Row, RelationName, Relationships, NewResultOne[], ClientOptions, ThrowOnError> | Sütunları seçin ve isteğe bağlı olarak ilgili kaynakları ekleyin (PostgREST eşlik). |
order(column: string, directionOrOptions?: 'asc' | 'desc' | OrderOptions): this | Bir sütuna göre sıralayın. |
limit(n: number): this | Döndürülen satır sayısını sınırlar. |
offset(n: number): this | İlk n satırları yok sayar (vardiya sayfalaması). |
range(from: number, to: number): this | Dizin aralığına göre sayfalar [başlangıç, bitiş] (dahil, 0 tabanı). |
cursor(cursor: string): this | Tuş takımı sayfalandırması: önceki sayfanın opak next_cursor değerini iletin (büyük tablolarda offset yerine tercih edilir: kararlı, kopyalama/atlama olmadan). |
count(mode?: CountMode): this | count içinde döndürülen eşleşen satırların toplam sayısını (varsayılan 'exact' veya 'estimated') ister. |
single<ResultOne = Result extends (infer U)[] ? U : Result>(): AuraPostgrestBuilder<ClientOptions, ResultOne, ThrowOnError> | Tam olarak bir satır bekler ve nesnenin kendisini döndürür; 0 veya birkaç satır PGRST116 hatasını veriyor. |
maybeSingle<ResultOne = Result extends (infer U)[] ? U : Result>(): AuraPostgrestBuilder<ClientOptions, ResultOne | null, ThrowOnError> | single() gibi, ancak 0 satır bir hata değildir: data o zaman null olur. |
#
Sınıf
AuraPostgrestBuilder
Temel sınıf: paylaşılan durum, yapıcı, HTTP yürütme (then/_execute), throwOnError ve buildQueryString.
| Yöntem | Açıklama |
|---|---|
throwOnError(): this | İstek başarısız olduğunda ({ error } döndürmek yerine) bir istisna atar. |
buildQueryString(): string | Sorguyu çalıştırmadan PostgREST sorgu dizesini (seç, filtrele, sırala, sayfalara ayır) oluşturur; hata ayıklamak için kullanışlıdır. |
then<TResult1 = AuraResponse<Result>, TResult2 = never>(onfulfilled?: ((value: AuraResponse<Result>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2> | Sorguyu yürütür: Oluşturucu "o zaman kullanılabilir", basit bir await yeterlidir. |
Oluşturulan sayfa
Bu sayfa, SDK'nın tür bildirimlerinden ve yorumlarından oluşturulduğundan, yayınlanan koddan sapamaz. Çalışılan örnekler için kılavuzları okuyun.
Son güncelleme · 12 Eki 2026