Databases class
새 데이터베이스를 만들고 모든 데이터베이스 읽기/쿼리를 위한 작업
기존 데이터베이스 를 읽거나 삭제하는 경우 데이터베이스를 참조하세요. 를 사용합니다 client.database(id).
참고: 이러한 모든 작업은 고정된 예산에 대해 호출합니다.
이러한 호출이 애플리케이션을 사용하여 하위 선형으로 확장되도록 시스템을 디자인해야 합니다.
예를 들어 데이터베이스가 있는지 확인하기 위해 모든 단일 item.read() 호출 전에 를 호출 databases.readAll() 하지 마세요. 애플리케이션 시작 시 한 번 수행합니다.
속성
| client |
메서드
| create(Database |
데이터베이스를 만들기 위한 요청을 보냅니다. 데이터베이스는 사용자, 권한 및 컨테이너 집합을 관리합니다. 각 Azure Cosmos DB 데이터베이스 계정은 여러 개의 독립적인 명명된 데이터베이스를 지원할 수 있으며 데이터베이스는 데이터의 논리적 컨테이너입니다. 각 데이터베이스는 하나 이상의 컨테이너로 구성되며, 각 컨테이너에는 하나 이상의 문서가 포함됩니다. 데이터베이스는 관리 리소스이므로 사용자 API를 사용하여 모든 작업에 액세스하고 성공적으로 완료하려면 서비스 마스터 키가 필요합니다. |
| create |
데이터베이스가 있는지 확인하고, 데이터베이스가 없는 경우 만듭니다.
이렇게 하면 의 ID 데이터베이스는 사용자, 권한 및 컨테이너 집합을 관리합니다. 각 Azure Cosmos DB 데이터베이스 계정은 여러 개의 독립적인 명명된 데이터베이스를 지원할 수 있으며 데이터베이스는 데이터의 논리적 컨테이너입니다. 각 데이터베이스는 하나 이상의 컨테이너로 구성되며, 각 컨테이너에는 하나 이상의 문서가 포함됩니다. 데이터베이스는 관리 리소스이므로 사용자 API를 사용하여 모든 작업에 액세스하고 성공적으로 완료하려면 서비스 마스터 키가 필요합니다. |
| query(string | Sql |
모든 데이터베이스를 쿼리합니다. 예제 배열에 대한 모든 데이터베이스를 읽습니다.
* |
| query<T>(string | Sql |
모든 데이터베이스를 쿼리합니다. 예제 배열에 대한 모든 데이터베이스를 읽습니다.
* |
| read |
모든 데이터베이스를 읽습니다. 예제 배열에 대한 모든 데이터베이스를 읽습니다.
* |
속성 세부 정보
client
메서드 세부 정보
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<any>
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 배열의 모든 데이터베이스를 반환하거나 한 번에 하나씩 반복할 수 있습니다. *