개체 DB 연결
데이터베이스 연결 개체는 데이터베이스 연결 세션을 설정하고 유지하는 데 사용됩니다.
계승
회원 속성
type
문자열, 현재 연결 데이터베이스 유형 쿼리
1readonly String DbConnection.type;
멤버 함수
close
현재 데이터베이스 연결 닫기
1DbConnection.close() async;
use
현재 데이터베이스 연결에 대한 기본 데이터베이스 선택
1DbConnection.use(String dbName) async;
호출 매개변수:
- dbName: 문자열, 데이터베이스 이름 지정
begin
현재 데이터베이스 연결에서 트랜잭션 시작
1DbConnection.begin(String point = "") async;
호출 매개변수:
- point: 문자열, 기본적으로 지정되지 않은 트랜잭션의 이름을 지정합니다.
commit
현재 데이터베이스 연결에서 트랜잭션 커밋
1DbConnection.commit(String point = "") async;
호출 매개변수:
- point: 문자열, 기본적으로 지정되지 않은 트랜잭션의 이름을 지정합니다.
rollback
현재 데이터베이스 연결에서 트랜잭션 롤백
1DbConnection.rollback(String point = "") async;
호출 매개변수:
- point: 문자열, 기본적으로 지정되지 않은 트랜잭션의 이름을 지정합니다.
trans
기능을 실행할 트랜잭션을 입력하고 기능 실행에 따라 제출 또는 롤백
1Boolean DbConnection.trans(Function func);
호출 매개변수:
- func: 함수, 트랜잭션 방식으로 실행되는 함수
반환 결과:
- Boolean, 트랜잭션이 커밋되었는지 여부를 반환하고 일반 커밋이면 true, 롤백이면 false를 반환하고 트랜잭션에 오류가 있으면 오류가 발생합니다.
func를 실행하면 세 가지 결과가 나타납니다.
- 함수는 작업 종료 및 활성 반환을 포함하여 정상적으로 반환되며, 이때 트랜잭션이 자동으로 커밋됩니다.
- 이 함수는 false를 반환합니다. 이때 트랜잭션은 롤백됩니다.
- 함수가 잘못 실행되고 트랜잭션이 자동으로 롤백됩니다.
기능을 실행할 트랜잭션을 입력하고 기능 실행에 따라 제출 또는 롤백
1
2Boolean DbConnection.trans(String point,
Function func);
호출 매개변수:
- point: 문자열, 트랜잭션 이름 지정
- func: 함수, 트랜잭션 방식으로 실행되는 함수
반환 결과:
- Boolean, 트랜잭션이 커밋되었는지 여부를 반환하고 일반 커밋이면 true, 롤백이면 false를 반환하고 트랜잭션에 오류가 있으면 오류가 발생합니다.
func를 실행하면 세 가지 결과가 나타납니다.
- 함수는 작업 종료 및 활성 반환을 포함하여 정상적으로 반환되며, 이때 트랜잭션이 자동으로 커밋됩니다.
- 이 함수는 false를 반환합니다. 이때 트랜잭션은 롤백됩니다.
- 함수가 잘못 실행되고 트랜잭션이 자동으로 롤백됩니다.
execute
sql 명령을 실행하고 실행 결과를 반환
1NArray DbConnection.execute(String sql) async;
호출 매개변수:
- sql: 문자열, 문자열
반환 결과:
- NArray, 결과 레코드가 포함된 배열을 반환합니다. 요청이 UPDATE 또는 INSERT인 경우 반환된 결과에도 영향을 받는 및 insertId가 포함됩니다. mssql은 insertId를 지원하지 않습니다.
sql 명령을 실행하고 실행 결과를 반환하고 매개변수에 따라 문자열을 형식화할 수 있습니다.
1
2NArray DbConnection.execute(String sql,
...args) async;
호출 매개변수:
- sql: 문자열, 형식 문자열, 선택적 매개변수는 ?로 지정됩니다. 예: 'SELECT FROM TEST WHERE [id]=?'
- args: ..., 선택적 매개변수 목록
반환 결과:
- NArray, 결과 레코드가 포함된 배열을 반환합니다. 요청이 UPDATE 또는 INSERT인 경우 반환된 결과에도 영향을 받는 및 insertId가 포함됩니다. mssql은 insertId를 지원하지 않습니다.
createTable
데이터 테이블 생성
1DbConnection.createTable(Object opts) async;
호출 매개변수:
- opts: 개체, 매개변수 목록
dropTable
데이터 테이블 삭제
1DbConnection.dropTable(Object opts) async;
호출 매개변수:
- opts: 개체, 매개변수 목록
createIndex
데이터 테이블 인덱스 생성
1DbConnection.createIndex(Object opts) async;
호출 매개변수:
- opts: 개체, 매개변수 목록
dropIndex
데이터 테이블 인덱스 삭제
1DbConnection.dropIndex(Object opts) async;
호출 매개변수:
- opts: 개체, 매개변수 목록
insert
새 레코드 삽입
1Number DbConnection.insert(Object opts) async;
호출 매개변수:
- opts: 개체, 매개변수 목록
반환 결과:
- Number, 삽입을 포함하는 ID를 반환하거나 엔진이 지원하지 않는 경우 0을 반환합니다.
find
지정된 조건에 따라 데이터 쿼리
1NArray DbConnection.find(Object opts) async;
호출 매개변수:
- opts: 개체, 매개변수 목록
반환 결과:
- NArray, 결과가 포함된 레코드를 반환합니다.
count
지정된 조건에 따라 데이터 레코드 수를 계산합니다.
1Integer DbConnection.count(Object opts) async;
호출 매개변수:
- opts: 개체, 매개변수 목록
반환 결과:
- Integer, 결과를 포함하는 레코드 수를 반환합니다.
update
지정된 조건에 따라 데이터 업데이트
1Integer DbConnection.update(Object opts) async;
호출 매개변수:
- opts: 개체, 매개변수 목록
반환 결과:
- Integer, 업데이트가 포함된 레코드 수를 반환합니다.
remove
지정된 조건에 따라 데이터 삭제
1Integer DbConnection.remove(Object opts) async;
호출 매개변수:
- opts: 객체, 선택적 매개변수 목록
반환 결과:
- Integer, 업데이트가 포함된 레코드 수를 반환합니다.
format
sql 명령을 형식화하고 형식화된 결과를 반환합니다.
1
2String DbConnection.format(String method,
Object opts);
호출 매개변수:
- method: 문자열, 요청된 메서드 지정
- opts: 객체, 선택적 매개변수 목록
반환 결과:
- String, 형식이 지정된 SQL 명령을 반환합니다.
sql 명령을 형식화하고 형식화된 결과를 반환합니다.
1
2String DbConnection.format(String sql,
...args);
호출 매개변수:
- sql: 문자열, 형식 문자열, 선택적 매개변수는 ?로 지정됩니다. 예: 'SELECT FROM TEST WHERE [id]=?'
- args: ..., 선택적 매개변수 목록
반환 결과:
- String, 형식이 지정된 SQL 명령을 반환합니다.
toString
개체의 문자열 표현을 반환하고 일반적으로 "[네이티브 개체]"를 반환하며 개체는 고유한 특성에 따라 다시 구현할 수 있습니다.
1String DbConnection.toString();
반환 결과:
- String, 객체의 문자열 표현을 반환합니다.
toJSON
객체의 JSON 형식 표현을 반환하고 일반적으로 객체에 의해 정의된 읽을 수 있는 속성 모음을 반환합니다.
1Value DbConnection.toJSON(String key = "");
호출 매개변수:
- key: 문자열, 미사용
반환 결과:
- Value, 직렬화 가능한 JSON을 포함하는 값을 반환합니다.