프로젝트 설정에서 데이터베이스 연결 세부 정보를 구성할 수 있습니다. 구성이 완료되면 사전/사후 프로세서 단계에서 데이터베이스 작업을 추가하여 엔드포인트 디버깅 및 테스트 중에 이러한 연결을 사용할 수 있습니다. 이를 통해 데이터베이스에서 데이터를 원활하게 읽거나 데이터베이스에 쓸 수 있습니다.Apidog 무료 버전은 다음 데이터베이스에 대한 연결을 지원합니다.SQL Server: SQL Server 2014 및 이후 버전을 지원합니다.
데이터베이스 연결 구성#
Apidog에서 데이터베이스 연결을 설정하려면 다음 단계를 따르십시오.1.
Project Settings → Database Connections를 엽니다.
2.
오른쪽 상단 모서리의 + New를 클릭하여 데이터베이스 연결을 생성합니다.
3.
사용 가능한 옵션에서 데이터베이스 유형을 선택하고, 호스트, 포트, 데이터베이스 이름, 사용자 이름, 비밀번호 등 필요한 연결 정보를 입력합니다. 변수를 사용하여 입력하는 것이 좋습니다. 전부 변수로 입력된 데이터베이스 연결은 협업을 위해 클라우드에 저장할 수 있습니다.
4.
사용자 이름과 비밀번호를 사용하는 로컬 연결 방식 외에도, 데이터 전송을 더 잘 보호하기 위해 SSH 터널을 통해 더 안전한 연결을 설정할 수 있습니다.
5.
Save를 클릭하면 이 연결을 사전/사후 프로세서에서 사용할 수 있습니다.
데이터베이스 연결 사용#
엔드포인트 요청 의 사전/사후 프로세서에 "Database Operations"를 추가하여 데이터베이스 연결을 참조할 수 있습니다. 추가한 후에는 "Database Operations"에서 데이터베이스 연결을 지정할 수 있습니다.데이터베이스 작업의 구체적인 단계는 다음과 같습니다.1.
Run 탭(Design Mode) 또는 Request 탭(Request Mode)에서 사전/사후 프로세서로 이동합니다.
2.
Add PreProcessor 또는 Add PostProcessor 위에 마우스를 올리고 Database Operation을 선택합니다.
3.
데이터베이스 작업의 이름을 지정하고 데이터베이스 연결을 구성합니다. 선택한 "Database Connection"이 올바르게 설정되어 있는지 확인하십시오. 자세히 알아보기. 4.
SQL 명령을 입력합니다. 명령에서 {{variables}}와 같은 변수가 지원됩니다.
5.
필요한 경우 Extract Result To Variable(JSONPath 지원)을 활성화하고 Console Log를 켭니다.
6.
Send를 클릭하여 엔드포인트 요청을 실행하고, 콘솔에서 결과를 확인합니다.
Apidog는 표준 SQL 쿼리를 지원하지만 저장 프로시저와 같은 복잡한 SQL 작업은 지원하지 않습니다.
중요 참고 사항#
요청을 통해 데이터베이스 작업을 실행하기 전에, 구성된 데이터베이스 연결이 올바르게 저장되어 있는지 확인하십시오.데이터베이스 연결이 변수를 사용하고 클라우드에 저장되어 있는 경우, 관련 변수의 Current Value 필드에 실제 데이터베이스 세부 정보(예: 호스트, 사용자 이름, 비밀번호 등)를 설정해야 합니다. 또는 변수 설정 방법을 사용하여 이러한 값을 동적으로 구성할 수 있습니다.
데이터베이스 연결이 고정 텍스트를 사용하고 로컬에 저장되어 있는 경우, Project Settings → Database Connection에서 실제 데이터베이스 세부 정보(예: 호스트, 사용자 이름, 비밀번호 등)를 입력해야 합니다.
저장 메커니즘 및 데이터 보안#
현재 Apidog는 데이터베이스 연결을 저장하는 두 가지 방법을 제공합니다.Apidog Cloud에 저장: 데이터베이스 연결이 전부 변수로 구성된 경우, Apidog의 클라우드 서버에 변수로 저장됩니다.
로컬에 저장: 데이터베이스 연결이 고정 텍스트를 사용하여 구성된 경우, 로컬 구성 파일에 일반 텍스트로 저장됩니다.
저장 메커니즘 간 차이점#
| 저장 메커니즘 | 저장 방법 | 장점 | 단점 |
|---|
| 클라우드 | 구성에서 변수 사용 | 1. 팀원과 더 편리하게 협업할 수 있습니다.
2. CI, Runner 등을 통해 테스트 시나리오를 실행할 때 로컬 파일을 유지 관리하는 대신 변수를 사용하여 데이터베이스 연결 세부 정보를 설정할 수 있습니다. | ⚠️ 변수의 초기값에 일반 텍스트를 사용하면 데이터베이스 이름 및 비밀번호와 같은 데이터가 일반 텍스트로 Apidog의 클라우드 서버에 전송되어 데이터 보안 위험이 발생합니다(변수에 현재 값을 사용하면 데이터가 로컬에 저장되어 이 위험이 제거됩니다). 데이터 보안 위험을 방지하려면 vault variables를 사용하는 것이 좋습니다. |
| 로컬 | 구성에서 고정 텍스트 사용 | 로컬에 저장되므로 보안 위험이 없습니다. | 1. 협업이 원활하지 않습니다. 각 팀원이 데이터베이스 연결을 개별적으로 구성해야 합니다.
2. CI, Runner 또는 유사한 도구를 통해 테스트 시나리오를 실행할 때 데이터베이스 연결을 위한 전용 로컬 파일을 유지 관리해야 합니다. |
뛰어난 사용자 경험과 데이터 보안의 균형을 맞추기 위해, Apidog는 데이터베이스 연결을 클라우드에 저장하고 Vault 변수를 사용하여 데이터 안전을 보장할 것을 권장합니다. 데이터베이스 연결과 관련된 변수의 초기값에 일반 텍스트를 사용하는 것은 심각한 데이터 보안 위험으로 이어질 수 있으 므로 강력히 권장하지 않습니다.
