다음을 통해 공유


Databases class

새 데이터베이스를 만들고 모든 데이터베이스 읽기/쿼리를 위한 작업

기존 데이터베이스 를 읽거나 삭제하는 경우 데이터베이스를 참조하세요. 를 사용합니다 client.database(id).

참고: 이러한 모든 작업은 고정된 예산에 대해 호출합니다. 이러한 호출이 애플리케이션을 사용하여 하위 선형으로 확장되도록 시스템을 디자인해야 합니다. 예를 들어 데이터베이스가 있는지 확인하기 위해 모든 단일 item.read() 호출 전에 를 호출 databases.readAll() 하지 마세요. 애플리케이션 시작 시 한 번 수행합니다.

속성

client

메서드

create(DatabaseRequest, RequestOptions)

데이터베이스를 만들기 위한 요청을 보냅니다.

데이터베이스는 사용자, 권한 및 컨테이너 집합을 관리합니다. 각 Azure Cosmos DB 데이터베이스 계정은 여러 개의 독립적인 명명된 데이터베이스를 지원할 수 있으며 데이터베이스는 데이터의 논리적 컨테이너입니다.

각 데이터베이스는 하나 이상의 컨테이너로 구성되며, 각 컨테이너에는 하나 이상의 문서가 포함됩니다. 데이터베이스는 관리 리소스이므로 사용자 API를 사용하여 모든 작업에 액세스하고 성공적으로 완료하려면 서비스 마스터 키가 필요합니다.

createIfNotExists(DatabaseRequest, RequestOptions)

데이터베이스가 있는지 확인하고, 데이터베이스가 없는 경우 만듭니다. 이렇게 하면 의 ID body를 기반으로 읽기 작업이 수행되고, 없으면 만들기 작업이 수행됩니다.

데이터베이스는 사용자, 권한 및 컨테이너 집합을 관리합니다. 각 Azure Cosmos DB 데이터베이스 계정은 여러 개의 독립적인 명명된 데이터베이스를 지원할 수 있으며 데이터베이스는 데이터의 논리적 컨테이너입니다.

각 데이터베이스는 하나 이상의 컨테이너로 구성되며, 각 컨테이너에는 하나 이상의 문서가 포함됩니다. 데이터베이스는 관리 리소스이므로 사용자 API를 사용하여 모든 작업에 액세스하고 성공적으로 완료하려면 서비스 마스터 키가 필요합니다.

query(string | SqlQuerySpec, FeedOptions)

모든 데이터베이스를 쿼리합니다.

예제

배열에 대한 모든 데이터베이스를 읽습니다. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @db", * parameters: [ * {name: "@db", value: "Todo"} * ] * }; * const {body: databaseList} = await client.databases.query(querySpec).fetchAll(); *

query<T>(string | SqlQuerySpec, FeedOptions)

모든 데이터베이스를 쿼리합니다.

예제

배열에 대한 모든 데이터베이스를 읽습니다. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @db", * parameters: [ * {name: "@db", value: "Todo"} * ] * }; * const {body: databaseList} = await client.databases.query(querySpec).fetchAll(); *

readAll(FeedOptions)

모든 데이터베이스를 읽습니다.

예제

배열에 대한 모든 데이터베이스를 읽습니다. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

속성 세부 정보

client

client: CosmosClient

속성 값

메서드 세부 정보

create(DatabaseRequest, RequestOptions)

데이터베이스를 만들기 위한 요청을 보냅니다.

데이터베이스는 사용자, 권한 및 컨테이너 집합을 관리합니다. 각 Azure Cosmos DB 데이터베이스 계정은 여러 개의 독립적인 명명된 데이터베이스를 지원할 수 있으며 데이터베이스는 데이터의 논리적 컨테이너입니다.

각 데이터베이스는 하나 이상의 컨테이너로 구성되며, 각 컨테이너에는 하나 이상의 문서가 포함됩니다. 데이터베이스는 관리 리소스이므로 사용자 API를 사용하여 모든 작업에 액세스하고 성공적으로 완료하려면 서비스 마스터 키가 필요합니다.

function create(body: DatabaseRequest, options?: RequestOptions): Promise<DatabaseResponse>

매개 변수

body
DatabaseRequest

만들 데이터베이스를 나타내는 DatabaseDefinition입니다.

options
RequestOptions

를 사용하여 응답 페이지 크기, 연속 토큰 등과 같은 옵션을 설정합니다.

반환

Promise<DatabaseResponse>

createIfNotExists(DatabaseRequest, RequestOptions)

데이터베이스가 있는지 확인하고, 데이터베이스가 없는 경우 만듭니다. 이렇게 하면 의 ID body를 기반으로 읽기 작업이 수행되고, 없으면 만들기 작업이 수행됩니다.

데이터베이스는 사용자, 권한 및 컨테이너 집합을 관리합니다. 각 Azure Cosmos DB 데이터베이스 계정은 여러 개의 독립적인 명명된 데이터베이스를 지원할 수 있으며 데이터베이스는 데이터의 논리적 컨테이너입니다.

각 데이터베이스는 하나 이상의 컨테이너로 구성되며, 각 컨테이너에는 하나 이상의 문서가 포함됩니다. 데이터베이스는 관리 리소스이므로 사용자 API를 사용하여 모든 작업에 액세스하고 성공적으로 완료하려면 서비스 마스터 키가 필요합니다.

function createIfNotExists(body: DatabaseRequest, options?: RequestOptions): Promise<DatabaseResponse>

매개 변수

body
DatabaseRequest

만들 데이터베이스를 나타내는 DatabaseDefinition입니다.

options
RequestOptions

요청에 대한 추가 옵션

반환

Promise<DatabaseResponse>

query(string | SqlQuerySpec, FeedOptions)

모든 데이터베이스를 쿼리합니다.

예제

배열에 대한 모든 데이터베이스를 읽습니다. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @db", * parameters: [ * {name: "@db", value: "Todo"} * ] * }; * const {body: databaseList} = await client.databases.query(querySpec).fetchAll(); *

function query(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<any>

매개 변수

query

string | SqlQuerySpec

작업에 대한 쿼리 구성입니다. 쿼리를 구성하는 방법에 대한 자세한 내용은 SqlQuerySpec 을 참조하세요.

options
FeedOptions

를 사용하여 응답 페이지 크기, 연속 토큰 등과 같은 옵션을 설정합니다.

반환

QueryIterator 배열의 모든 데이터베이스를 반환하거나 한 번에 하나씩 반복할 수 있습니다. *

query<T>(string | SqlQuerySpec, FeedOptions)

모든 데이터베이스를 쿼리합니다.

예제

배열에 대한 모든 데이터베이스를 읽습니다. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @db", * parameters: [ * {name: "@db", value: "Todo"} * ] * }; * const {body: databaseList} = await client.databases.query(querySpec).fetchAll(); *

function query<T>(query: string | SqlQuerySpec, options?: FeedOptions): QueryIterator<T>

매개 변수

query

string | SqlQuerySpec

작업에 대한 쿼리 구성입니다. 쿼리를 구성하는 방법에 대한 자세한 내용은 SqlQuerySpec 을 참조하세요.

options
FeedOptions

를 사용하여 응답 페이지 크기, 연속 토큰 등과 같은 옵션을 설정합니다.

반환

QueryIterator 배열의 모든 데이터베이스를 반환하거나 한 번에 하나씩 반복할 수 있습니다. *

readAll(FeedOptions)

모든 데이터베이스를 읽습니다.

예제

배열에 대한 모든 데이터베이스를 읽습니다. * typescript * const {body: databaseList} = await client.databases.readAll().fetchAll(); *

function readAll(options?: FeedOptions): QueryIterator<DatabaseDefinition & Resource>

매개 변수

options
FeedOptions

를 사용하여 응답 페이지 크기, 연속 토큰 등과 같은 옵션을 설정합니다.

반환

QueryIterator 배열의 모든 데이터베이스를 반환하거나 한 번에 하나씩 반복할 수 있습니다. *