클라이언트 및 서비스
SDK의 진입점: 클라이언트를 생성하는 방법과 클라이언트가 노출하는 서비스.
6분 읽기·레벨 참조·2026. 10. 12.에 개정됨
이 영어 텍스트는 프랑스어 원본에서 자동으로 생성되었으며 아직 검토되지 않았습니다.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
#
기능
내보낸 함수
| 기능 | 설명 |
|---|---|
function createClient<Database = any>(baseUrl: string, apiKey: string, options?: AuraClientOptions): AuraClient<Database> | 새 Aurabase 클라이언트 인스턴스를 만듭니다. |
function createAdminClient<Database = any>(baseUrl: string, serviceRoleKey: string, options?: AuraClientOptions): AuraClient<Database> | 관리 작업(client.authAdmin: 사용자 목록/생성/금지, 감사 읽기)을 위해서만 SERVER 사용을 위한 클라이언트를 생성합니다. |
#
수업
아우라클라이언트
기본 Aurabase 클라이언트.
| 재산 | 설명 |
|---|---|
readonly baseUrl: string | 후행 막대가 없는 프로젝트 URL(https://<slug>.aurabase.cloud). |
readonly apiKey: string | null | apikey 헤더에 전송된 프로젝트 API 키(anon 또는 service_role). null(아무것도 제공되지 않은 경우) |
readonly fetchFn: typeof globalThis.fetch | 모든 쿼리에 사용되는 함수 fetch( options.fetch, 그렇지 않으면 globalThis.fetch). |
readonly authStore: BaseAuthStore | 세션 저장소(액세스 토큰, 새로 고침 토큰, 사용자): 컨텍스트에 따라 메모리, localStorage 또는 쿠키. |
readonly retryConfig: { enabled: boolean; maxRetries: number; } | 일시적인 오류에 대한 읽기 요청 재개 정책(GET, HEAD): 활성화 여부 및 최대 재개 횟수. |
readonly requestTimeoutMs?: number | 신호가 없는 JSON 요청의 기본 시간 초과(ms)입니다. undefined → 코어 결함(30초). |
readonly onEvent?: (event: AuraObservabilityEvent) => void | 관찰 가능성 후크 — AuraClientOptions.onEvent를 참조하세요. |
readonly debug?: boolean | Journalise chaque AuraObservabilityEvent via console.debug — voir AuraClientOptions.debug. |
get auth(): AuthService | 인증 서비스: 등록, 연결, 세션, MFA, OAuth, ID. |
get authAdmin(): AuthAdminService | 인증 관리 API(사용자, 세션, 감사 로그, 이메일 템플릿) |
get db(): DatabaseService<Database, Schema> | 데이터베이스 서비스: 테이블 및 뷰에 대한 쿼리, SQL 함수 호출(rpc), 원시 SQL. |
get storage(): StorageService | 스토리지 서비스: 버킷, 전송, 다운로드, 서명 및 공개 URL, 이미지 변환. |
get realtime(): RealtimeService | 실시간 서비스: 채널, Postgres 변경, 방송(broadcast) 및 현재 상태. |
get functions(): FunctionsService | Edge Functions 서비스: service_role 키를 사용하여 작업 및 크론을 호출하고 관리합니다. |
get ai(): AiService | AI 서비스: 대화(chat), 임베딩, RAG(수집, 쿼리, 네임스페이스), 의미 검색 및 세션. |
get notifications(): NotificationsService | 알림 서비스: 전송(이메일, SMS, 푸시, 웹훅), 기록, 템플릿 및 관리. |
| 방법 | 설명 |
|---|---|
dispose(): void | 클라이언트 마운트 해제: 사전 새로 고침(티커 + 가시성 + BroadcastChannel)을 중지하고 실시간 연결을 끊고 인증 리스너를 비웁니다. |
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> | 단축키: 데이터베이스 테이블 또는 뷰를 쿼리합니다(Supabase-호환 API). |
rpc<FnName extends string = string, Args extends Record<string, unknown> = Record<string, unknown>>(fn: FnName, args?: Args, options?: Parameters<DatabaseService<Database, Schema>['rpc']>[2]): ReturnType<DatabaseService<Database, Schema>['rpc']> | 단축키: RPC(Supabase호환 API)를 통해 저장 프로시저/PostgreSQL 함수를 호출합니다. |
channel(name: string, options?: ChannelConfig): AuraChannel | 지름길: Supabase호환 API를 사용하여 실시간 채널을 생성합니다. |
removeChannel(channel: string | AuraChannel): void | 지름길: 이름 또는 AuraChannel 인스턴스로 실시간 채널을 제거합니다. |
removeAllChannels(): void | 지름길: 모든 실시간 채널을 제거하고 구독을 취소하세요. |
getChannels(): AuraChannel[] | 바로가기: 모든 활성 실시간 채널을 나열합니다. |
생성된 페이지
이 페이지는 SDK의 유형 선언 및 주석에서 생성되므로 게시된 코드에서 표류할 수 없습니다. 실제 사례를 보려면 가이드를 읽어보세요.
마지막 업데이트 · 2026. 10. 12.