개발용 Visual Studio 코드 확장 사용Using Visual Studio Code Extension for Development

Oracle NoSQL Database Cloud Service는 실행 중인 Oracle NoSQL Database Cloud Service 인스턴스에 연결할 수 있는 Microsoft Visual Studio Code에 대한 확장을 제공합니다.

Oracle NoSQL Database VS(Visual Studio) 코드 확장을 사용하여 다음을 수행할 수 있습니다.

• 테이블 탐색기를 사용하여 잘 정의된 트리 구조의 테이블을 봅니다.
• 테이블의 열, 인덱스, 기본 키 및 샤드 키에 대한 정보를 봅니다.
• 올바른 형식의 JSON 구조로 열 데이터를 봅니다.
• form 기반 스키마 항목을 사용하여 테이블을 생성하거나 DDL 문을 제공합니다.
• 테이블 삭제.
• form 기반 항목을 사용하여 새 열을 추가하거나 DDL 문을 제공합니다.
• 열 삭제.
• 인덱스 생성.
• 인덱스 삭제.
• 테이블에서 SELECT SQL query를 실행하고 테이블 형식으로 query 결과를 확인합니다.
• DML 문을 실행하여 테이블에서 데이터를 갱신, 삽입 및 삭제합니다.
• SELECT 질의를 실행한 후 JSON 파일로 질의 결과를 다운로드합니다.
• SELECT 질의를 실행한 후 얻은 결과의 각 행을 JSON 파일로 다운로드합니다.

이 문서에는 다음 항목이 있습니다.

Oracle NoSQL Database Visual Studio Code 확장 설치

Oracle NoSQL Database VS Code 확장은 두 가지 방법으로 설치할 수 있습니다. 온라인 설치를 위해 Visual Studio Marketplace에서 설치하거나 오프라인 설치를 위해 *.vsix 파일을 사용하여 VSIX 패키지에서 설치합니다.

Oracle NoSQL Database VS(Visual Studio) 코드 확장을 설치하려면 먼저 Visual Studio 코드를 설치해야 합니다. 여기에서 Visual Studio Code를 다운로드할 수 있습니다.

• Visual Studio Marketplace에서 설치
• VSIX에서 설치

1. Visual Studio Code에서 왼쪽 탐색의 확장 아이콘을 누릅니다.

   
   

   
   
   
   또는 다음을 눌러 확장 기능 보기를 열 수 있습니다.

   • (Windows 및 Linux) Control + Shift + X
   • (macOS) 명령 + Shift + X.
2. 확장 마켓플레이스에서 Oracle NoSQL Database Connector를 검색합니다.
3. Oracle NoSQL Database Connector 확장에서 설치를 누릅니다.

1. Oracle NoSQL Database용 VSIX 파일을 Oracle NoSQL Database 다운로드 사이트에서 다운로드합니다.
2. Visual Studio Code에서 왼쪽 탐색의 확장 아이콘을 누릅니다.

   
   

   
   
   
   또는 다음을 눌러 확장 기능 보기를 열 수 있습니다.

   • (Windows 및 Linux) Control + Shift + X
   • (macOS) 명령 + Shift + X.
3. 확장 보기에서 추가 작업(...) 메뉴를 누른 다음 VSIX에서 설치...를 누릅니다.

   
   

   
   
   

4. *.vsix 파일이 저장된 위치로 이동하고 Install을 누릅니다.

Visual Studio Code에서 Oracle NoSQL Database Cloud Service에 연결하기

Oracle NoSQL Database VS(Visual Studio) 코드 확장은 Oracle NoSQL Database Cloud Service 또는 Oracle NoSQL Database Cloud Simulator에 연결하는 두 가지 방법을 제공합니다.

구성 파일에 연결 정보를 제공하거나 특정 필드에 연결 정보를 입력할 수 있습니다. Node.js 드라이버를 사용하고 있으며 이미 파일에 접속 세부정보가 저장되어 있는 경우 [구성 파일을 통해 접속] 옵션을 사용하여 Oracle NoSQL Database Cloud Service에 접속합니다. 그렇지 않으면 새 연결을 생성하는 경우 [개별 필드에 채우기] 옵션을 사용합니다.

• 개별 필드 채우기
• 구성 파일을 통해 연결

1. Visual Studio Code에서 작업 표시줄의 Oracle NoSQL DB 보기를 누릅니다.

   
   

   
   
   

2. 명령 팔레트의 Oracle NoSQL DB 접속 설정 표시 페이지를 열거나 작업 표시줄의 Oracle NoSQL DB 뷰를 엽니다.
   • 명령 팔레트에서 열기
     1. 다음을 눌러 명령 팔레트를 엽니다.
        • (Windows 및 Linux) 제어 + Shift + P
        • (macOS) 명령 + Shift + P
     2. 명령 팔레트에서 OracleNoSQL: 연결 설정 표시를 선택합니다.

        참고:

        명령 팔레트에 oraclenosql을 입력하여 사용할 수 있는 모든 Oracle NoSQL DB 명령을 표시합니다.

        
        

        
        
        

   • Oracle NoSQL DB 뷰에서 열기
     1. 축소된 경우 왼쪽 탐색에서 TABLE EXPLORER 창을 확장합니다.
     2. 연결 추가를 눌러 Oracle NoSQL DB 연결 설정 표시 페이지를 엽니다.

     
     

     
     
     

3. 접속 설정 표시 페이지에서 클라우드 또는 CloudSim를 눌러 Oracle NoSQL Database Cloud Service 또는 Oracle NoSQL Database Cloud Simulator에 연결합니다.

   
   

   
   
   

4. 접속 정보 입력.

   테이블 - 클라우드 접속 매개변수

   필드	설명	샘플 값
   지역:	Oracle NoSQL Database Cloud Service 엔드포인트의 지역 식별자를 선택합니다.	us-ashburn-1
   구성 파일:	OCI 구성 파일이 저장된 위치로 이동합니다.	/home/user/security/config/oci.config
   프로파일:	Oracle NoSQL Database Cloud Service 연결에 사용할 구성 프로파일의 이름입니다. 이 값을 지정하지 않은 경우 필드는 기본적으로 DEFAULT 프로파일로 설정됩니다.	ADMIN_USER
   구획:	Oracle NoSQL Database Cloud Service 스키마에 대한 구획의 이름 또는 OCID입니다. 값을 제공하지 않으면 필드가 기본적으로 root 구획으로 설정됩니다. Oracle Cloud Infrastructure IAM(ID 및 액세스 관리)에서 구획을 생성합니다. 테넌시 설정 및 Oracle Cloud Infrastructure 문서의 구획 관리를 참조하십시오.	구획 이름 내 구획 해당 상위 구획으로 한정된 컴파트먼트 이름입니다. parent.childcompartment 컴파운드 OCID ocid1.tenancy.oc1...<unique_ID>
   테넌트 OCID:	Oracle NoSQL Database Cloud Service에 대한 테넌시의 OCID입니다. Oracle Cloud Infrastructure 문서에서 테넌시의 OCID 및 사용자 OCID를 얻을 수 있는 위치를 참조하십시오.	ocid1.tenancy.oc1..<unique_ID>
   사용자 OCID:	Oracle NoSQL Database Cloud Service의 사용자 OCID입니다. Oracle Cloud Infrastructure 문서에서 테넌시의 OCID 및 사용자 OCID를 얻을 수 있는 위치를 참조하십시오.	ocid1.user.oc1..<unique_ID>
   Fingerprint:	이 사용자에게 추가된 전용 키의 지문입니다. API 서명 키를 생성하고 업로드하는 동안 서명 키의 지문이 생성됩니다. Oracle Cloud Infrastructure 설명서의 키 지문을 가져오는 방법을 참조하십시오.	12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef
   전용 키 파일:	개인 키가 저장된 위치를 찾습니다. 선택적 문장암호로 서명 키를 생성하려면 How to Generate an API Signing Key을 참조하십시오.	/home/user/.oci/oci_api_key.pem
   문장암호:	개인 키를 만들 때 지정한 문장암호입니다. API 서명 키를 생성하고 업로드하는 동안 서명 키의 비밀번호 구문이 생성됩니다. Oracle Cloud Infrastructure 설명서의 키 지문을 가져오는 방법을 참조하십시오. 필수, 키가 암호화된 경우에만.
   구획:	Oracle NoSQL Database Cloud Service 스키마에 대한 구획의 이름 또는 OCID입니다. 값을 제공하지 않으면 필드가 기본적으로 root 구획으로 설정됩니다. Oracle Cloud Infrastructure IAM(ID 및 액세스 관리)에서 구획을 생성합니다. 테넌시 설정 및 Oracle Cloud Infrastructure 문서의 구획 관리를 참조하십시오.	구획 이름 내 구획 해당 상위 구획으로 한정된 컴파트먼트 이름입니다. parent.childcompartment 컴파운드 OCID ocid1.tenancy.oc1...<unique_ID>

   표 - CloudSim 접속 매개변수

   필드	설명	샘플 값
   Endpoint:	Oracle NoSQL Database Cloud Simulator 인스턴스의 서비스 끝점 URL입니다.	http://myinstance.cloudsim.com:8080 값을 지정하지 않으면 기본값이 http://localhost:8080로 설정됩니다.
   테넌트 식별자:	테넌트를 식별하는 고유 식별자입니다.	Tenant01 값을 지정하지 않으면 기본값이 TestTenant로 설정됩니다.

5. 접속을 누릅니다.
6. 재설정을 눌러 작업 영역에서 저장된 접속 세부정보를 지웁니다.

1. 구성 파일(예: config.json 또는 JSON 객체가 있는 파일)을 생성합니다. Oracle NoSQL Database Cloud Service 또는 Oracle NoSQL Database Cloud Simulator에 연결하기 위한 구성 파일 형식은 다음과 같습니다.

   테이블 - 구성 템플리트

   Oracle NoSQL Database Cloud Service

   Oracle NoSQL Database Cloud 시뮬레이터

   OCI 구성 파일을 사용하여 접속하기 위한 구성 템플리트입니다. { "region": "<region-id-of-nosql-cloud-service-endpoint>", "compartment": "<oci-compartment-name-or-id>", "auth": { "iam": { "configFile": "<path-to-OCI-config-file>",  "profileName": "<oci-credentials-profile-name>" } } } IAM 인증 인증서를 사용하여 접속할 구성 템플리트입니다. { "region": "<region-id-of-nosql-cloud-service-endpoint>", "compartment": "<oci-compartment-name-or-id>", "auth": { "iam": { "tenantId": "<tenancy-ocid>", "userId": "<user-ocid>", "fingerprint": "<fingerprint-for-the-signing-key>", "privateKeyFile": "<path-to-the-private-key>", "passphrase": "<passphrase-of-the-signing-key>" } } }

   { "endpoint": "http://myinstance.cloudsim.com:8080", "auth" : "Bearer<tenant-id>" }

2. 다음을 눌러 명령 팔레트를 엽니다.
   • (Windows 및 Linux) Control + Shift + X
   • (macOS) 명령 + Shift + X
3. 명령 팔레트에서 Oracle NoSQL: 구성 파일을 통해 연결을 선택합니다.

   참고:

   명령 팔레트에 oraclenosql을 입력하여 사용할 수 있는 모든 Oracle NoSQL DB 명령을 표시합니다.

   
   

   
   
   

4. *.config 파일이 저장된 위치로 이동하고 선택을 누릅니다.

Visual Studio 코드 확장을 사용하여 테이블 관리Managing Tables Using Visual Studio Code Extension

Oracle NoSQL Database VS(Visual Studio) 코드 확장을 사용하여 배포에 연결한 후 왼쪽 탐색에 있는 TABLE EXPLORER를 사용하여 다음을 수행합니다.

• 테이블, 열, 인덱스, 기본 키 및 샤드 키를 탐색합니다.
• 새 테이블 생성.
• 기존 테이블을 삭제합니다.
• 인덱스 생성.
• 인덱스 삭제.
• 열 추가.
• 열 삭제.
• 테이블에 데이터 삽입.
• SELECT SQL 질의를 실행합니다.

테이블, 열, 인덱스 및 키 탐색

활성 연결을 확장하면 Oracle NoSQL Database VS Code에 해당 배포의 테이블이 표시됩니다.

• 테이블 이름을 눌러 해당 열, 인덱스, 기본 키 및 샤드 키를 봅니다. 열 이름이 해당 데이터 유형과 함께 표시됩니다.
• 언제든지 스키마 또는 테이블을 새로고침하여 배포를 재질의하고 Oracle NoSQL Database Cloud Service를 최신 데이터로 채울 수 있습니다.
  • 테이블 탐색기에서 접속을 찾고 [새로고침] 아이콘을 눌러 스키마를 다시 로드합니다. 또는 접속을 마우스 오른쪽 단추로 누르고 스키마 새로고침을 선택할 수 있습니다.

    
    

    
    
    

  • TABLE EXPLORER에서 테이블 이름을 찾고 [새로고침] 아이콘을 눌러 테이블을 다시 로드합니다. 또는 테이블 이름을 마우스 오른쪽 단추로 누르고 테이블 새로고침을 선택할 수 있습니다.

    
    

    
    
    

Visual Studio 코드를 사용하여 DDL 작업 수행

Visual Studio Code를 사용하여 DDL 작업을 수행할 수 있습니다.You can use Visual Studio Code to perform DDL operations

Visual Studio Code 플러그인 내에서 수행할 수 있는 몇 가지 DDL 작업은 다음과 같습니다.Some of the DDL operations that can be performed from inside the Visual Studio Code plugin

• CREATE TABLE
• 테이블 삭제
• 인덱스 생성
• 인덱스 삭제
• 열 추가
• 열 삭제

CREATE TABLE

Oracle NoSQL Database 테이블은 두 가지 모드로 생성할 수 있습니다.

• 단순 DDL 입력: 이 모드를 사용하여 DDL 문을 작성하지 않고 Oracle NoSQL Database 테이블을 선언적으로 생성할 수 있습니다.
• 고급 DDL 입력: 이 모드를 사용하면 DDL 문을 사용하여 Oracle NoSQL Database 테이블을 생성할 수 있습니다.

1. Oracle NoSQL Database 연결을 가리켜 새 테이블을 추가합니다.
2. 표시되는 더하기 아이콘을 누릅니다.
3. 테이블 생성 페이지에서 단순 DDL 입력을 선택합니다.

   
   

   
   
   

   테이블 - Oracle NoSQL Database 테이블 생성

   필드	설명
   테이블 이름:	고유한 테이블 이름을 지정합니다.
   열 이름	테이블의 기본 키에 대한 열 이름을 지정하십시오.
   열 유형	기본 키 열에 대한 데이터 유형을 선택합니다.
   샤드 키로 설정	이 기본 키 열을 샤드 키로 설정하려면 이 옵션을 선택합니다. 샤드 키는 효율성을 높이기 위해 Oracle NoSQL Database 클러스터에 데이터를 배포하고 쉽게 참조하고 액세스할 수 있도록 샤드 키를 로컬에 공유하는 레코드를 배치하는 것입니다. 샤드 키를 공유하는 레코드는 동일한 물리적 위치에 저장되며 원자적이고 효율적으로 액세스할 수 있습니다.
   제거	이 단추를 눌러 기존 열을 삭제합니다.
   + 기본 키 열 추가	조합(다중 열) 기본 키를 생성하는 동안 열을 추가하려면 이 단추를 누릅니다.
   열 이름	열 이름을 지정하십시오.
   열 유형	열에 대한 데이터 유형을 선택합니다.
   기본값	(선택 사항) 열의 기본값을 지정합니다. 주: 바이너리 및 JSON 데이터 유형 열에 대한 기본값을 지정할 수 없습니다.
   널이 아님	열에 항상 값이 있어야 하도록 지정하려면 이 옵션을 선택합니다.
   제거	이 단추를 눌러 기존 열을 삭제합니다.
   + 열 추가	열을 더 추가하려면 이 단추를 누르십시오.
   단위	테이블의 행에 대한 TTL 값에 사용할 단위(일 또는 시간)를 선택합니다.
   값	테이블의 행에 대한 만료 기간을 지정합니다. 일 또는 시간 후 행은 자동으로 만료되어 더 이상 사용할 수 없습니다. 기본값은 0이며 만료 시간이 없음을 나타냅니다. 주: TTL(테이블 보관 시간)을 갱신해도 테이블에 있는 기존 데이터의 TTL 값은 변경되지 않습니다. 새 TTL 값은 이 값이 수정된 후 테이블에 추가된 행과 대체 행별 값이 제공되지 않은 행에만 적용됩니다.

4. 단순 DDL 입력 모드의 필드에 입력된 값을 기반으로 구성된 DDL 문을 보려면 DDL 표시를 누릅니다. 이 DDL 문은 생성을 누르면 실행됩니다.
5. 생성을 누릅니다.

테이블 삭제

1. 대상 테이블을 마우스 오른쪽 버튼으로 누릅니다.
2. 테이블 삭제를 누릅니다.
3. 예를 눌러 테이블을 삭제합니다.

인덱스 생성

• 테이블 탐색기를 찾은 다음 Refresh Schema를 눌러 스키마를 재로드합니다.
• 인덱스를 생성해야 하는 테이블을 마우스 오른쪽 단추로 누릅니다. 인덱스 생성을 선택합니다.
• 인덱스의 이름과 인덱스의 일부가 될 열을 지정합니다.
• 색인 추가를 누릅니다.

인덱스 삭제

• 테이블 탐색기를 찾은 다음 Refresh Schema를 눌러 스키마를 재로드합니다.
• 인덱스를 제거해야 하는 테이블을 누릅니다. 인덱스 목록이 열 이름 아래에 표시됩니다.
• 삭제할 인덱스를 마우스 오른쪽 버튼으로 누릅니다. 인덱스 삭제를 누릅니다.
• 확인 창이 나타나면 확인을 눌러 삭제 작업을 확인합니다.

열 추가

• 테이블 탐색기를 찾은 다음 Refresh Schema를 눌러 스키마를 재로드합니다.
• 열을 추가해야 하는 테이블을 마우스 오른쪽 단추로 누릅니다. 열 추가를 누릅니다.
• 열 이름을 지정하고 해당 속성(데이터 유형, 기본값 및 널 가능 여부)으로 열을 정의합니다.
• 새 열 추가를 누릅니다.

열 삭제

• 테이블 탐색기를 찾은 다음 Refresh Schema를 눌러 스키마를 재로드합니다.
• 열을 제거해야 하는 테이블을 확장합니다.
• 제거할 열을 마우스 오른쪽 단추로 누르고 열 삭제를 선택합니다.
• 확인 창이 나타나면 확인을 눌러 삭제 작업을 확인합니다.

Visual Studio 코드를 사용하여 DML 작업 수행

usingVisual Studio Code 플러그인에서 데이터를 추가하고, 기존 데이터를 수정하고, 데이터를 쿼리할 수 있습니다.

데이터 삽입

• 테이블 탐색기를 찾은 다음 Refresh Schema를 눌러 스키마를 재로드합니다.
• 행을 삽입해야 하는 테이블을 마우스 오른쪽 단추로 누릅니다. 행 삽입을 선택합니다.
• [행 삽입] 패널에서 새 행을 삽입할 세부 정보를 입력합니다. 다음 두 가지 모드로 새 ROW를 삽입할 수 있습니다.
  • 단순 입력: DML 문을 작성하지 않고 이 모드를 사용하여 새 행을 삽입할 수 있습니다. 여기서 행에 있는 모든 필드의 값을 입력할 수 있는 폼 기반 행 필드 항목이 로드됩니다.
  • 고급 JSON 입력: 이 모드를 사용하면 열 이름과 해당 값을 키-값 쌍으로 포함하는 JSON 객체를 제공하여 테이블에 새 행을 삽입할 수 있습니다.
• 행 삽입을 누릅니다.

데이터 수정 - UPDATE ROW/DELETE ROW:

• 테이블 탐색기를 찾은 다음 Refresh Schema를 눌러 스키마를 재로드합니다.
• 데이터를 수정해야 하는 테이블을 누릅니다.
• SQL> 오른쪽에 있는 텍스트 상자에 테이블에서 데이터를 인출할 SQL 문을 입력합니다. >를 눌러 쿼리를 실행합니다.
• 개별 셀 데이터를 개별적으로 보려면 테이블 셀을 누릅니다.
• 행 업데이트 및 삭제와 같은 DML 작업을 수행하려면 특정 행을 마우스 오른쪽 단추로 누릅니다. 나타나는 컨텍스트 메뉴에서 옵션을 선택합니다.
  • 행 삭제: 확인 창이 나타나면 확인을 눌러 행을 삭제합니다.
  • 행 업데이트 : 나열된 행 아래에 별도의 HTML 패널이 열리며, 양식 기반 항목에 열 이름과 해당 값을 포함하거나 입력을 ON 키 쌍 객체로 제공합니다. 두 방법 중 하나를 선택하고 새 값을 제공할 수 있습니다.

    주:

    모든 행에서 PRIMARY KEY 및 GENERATED ALWAYS AS IDENTITY 열은 갱신할 수 없습니다.

테이블에 대한 SQL 질의 실행

• 테이블 탐색기를 찾은 다음 Refresh Schema를 눌러 스키마를 재로드합니다.
• 테이블을 마우스 오른쪽 단추로 누르고 테이블 찾아보기를 선택합니다.
• SQL> 아래의 오른쪽 텍스트 상자에 SELECT 문을 입력하여 테이블에서 데이터를 인출합니다.
• >를 눌러 쿼리를 실행합니다. 해당 데이터가 테이블에서 검색됩니다.
• 임의의 행을 마우스 오른쪽 단추로 누르고 JSON 파일로 행 다운로드를 누릅니다. 단일 행이 JSON 파일로 다운로드됩니다.
• 질의 결과 다운로드를 눌러 SELECT 문의 전체 결과를 JSON 파일로 저장합니다.
• 모든 레코드 인출을 눌러 테이블에서 모든 데이터를 검색합니다.

접속을 제거 중

Oracle NoSQL Database Connector는 VS(Visual Studio) 코드에서 연결을 제거하는 두 가지 방법을 제공합니다.

다음을 수행할 수 있습니다.

• 명령 팔레트와 연결을 제거하거나
• 작업 표시줄의 Oracle NoSQL DB 뷰에서 연결을 제거합니다.

주:

Visual Studio Code에서 연결을 제거하면 현재 작업공간에서 지속된 연결 세부정보가 삭제됩니다.

• Oracle NoSQL DB 뷰에서 접속 제거
• 명령 팔레트로 접속 제거

1. 축소된 경우 왼쪽 탐색에서 TABLE EXPLORER 창을 확장합니다.
2. 제거할 접속을 마우스 오른쪽 단추로 누르고 접속 제거를 누릅니다.

1. 다음을 눌러 명령 팔레트를 엽니다.
   • (Windows 및 Linux) 제어 + Shift + P
   • (macOS) 명령 + Shift + P
2. 명령 팔레트에서 OracleNoSQL: 접속 제거를 선택합니다.

   참고:

   명령 팔레트에 oraclenosql을 입력하여 사용할 수 있는 모든 Oracle NoSQL DB 명령을 표시합니다.

   
   

   
   
   

---

제목 및 저작권 정보

개발용 Visual Studio 코드 확장 사용Using Visual Studio Code Extension for Development

Copyright ©2023,

Oracle and/or its affiliates.