스프레드시트 추가 기능의 UI 옵션

스프레드시트 추가 기능은 여러 기능 및 개별 패널에 대한 추가 제어에 공통 UI 요소를 제공합니다.

접속 정보

대부분의 추가 기능 패널의 위쪽 섹션에는 데이터베이스 URL, 스키마, 연결 상태 및 연결이 만료되기 전 남은 세션 시간 등 활성 연결에 대한 정보가 표시됩니다. OCI IAM 연결의 경우 연결된 사용자도 표시됩니다.

주:

애드인은 데이터베이스와의 활성 연결을 유지하지만 검색된 데이터는 스프레드시트에 로컬로 저장됩니다. 비활성 또는 연결 시간 초과의 경우 추가 기능에 통지가 표시되고 데이터베이스에 다시 연결하도록 제안합니다.

SQL 질의 편집기 사용

SQL 질의 편집기는 SQL 문을 실행하기 전에 작성, 편집 및 보는 영역입니다.

query를 수동으로 입력하거나 객체 브라우저에서 테이블, 뷰 및 열을 선택하여 SQL 문을 생성할 수 있습니다. SQL 질의 편집기는 질의에 대한 행 번호 및 구문 강조 표시를 표시합니다.

조회 편집기에서 사용할 수 있는 작업은 사용 중인 추가 기능에 따라 달라집니다. 일반적으로 SQL query 편집기에서 다음 옵션을 사용할 수 있습니다.

  • 실행

    삼각형이 있는 원으로 표시되는 첫번째 버튼은 Run 버튼입니다. SQL 문을 실행하고 선택한 워크시트에 query 결과를 표시하려면 이 버튼을 누릅니다.

  • SQL 내용 지우기

    실행 옆에 있는 지우개 아이콘은 질의 편집기에서 현재 SQL 문을 제거합니다.

  • 시트에서 질의 검색

    이 단추는 활성 워크시트에서 SQL 질의를 검색하여 SQL 질의 편집기에 표시합니다. 그런 다음 질의를 다시 편집하고 실행할 수 있습니다.

  • 테이블 하이퍼링크로 공유

    이 옵션은 직접 SQL 및 데이터 분석을 사용하여 생성된 질의 결과에 대해서만 사용할 수 있습니다. 읽기 전용 질의 결과를 스프레드시트로 로드할 수 있도록 테이블 하이퍼링크를 생성하고 다른 사용자와 공유합니다.

주:

Excel의 추가 기능은 추가 기능 창 재로드와 같은 추가 옵션이 포함된 부동 메뉴를 제공합니다. 추가 기능 창의 오른쪽에 있는 작은 화살표를 클릭하여 부동 메뉴를 엽니다.

질의 결과에 대한 워크시트 선택

기본 시트를 사용하거나 다른 시트를 선택하여 결과를 표시할 수 있습니다.

주:

동일한 워크시트에서 다른 질의를 실행하는 경우 추가 기능이 새 질의의 결과로 워크시트를 새로 고칩니다.

다른 조회에 다른 시트를 사용하려면 다음 중 하나를 수행합니다.

  • 스프레드시트 추가 기능에서 더하기(+) 단추를 누르고 새 워크시트 추가에서 이름을 지정한 다음 눈금 단추를 누릅니다. 추가 기능은 조회를 실행할 때 새 시트를 삽입합니다. 왼쪽 화살표 단추는 취소하고 뒤로 이동하는 것입니다.

  • Excel 또는 Google Sheets의 옵션을 사용하여 새 시트를 삽입합니다.

그런 다음 워크시트 선택에서 새 시트를 선택하고 결과를 볼 수 있습니다.

정보 질의

이 워크시트는 query 결과와 함께 다음 query 정보도 표시합니다.

  • 데이터베이스 URL로

  • 질의를 생성하고 실행하는 데이터베이스 사용자 또는 스키마

  • 실제 SQL Query

  • 새로고침 구성

  • 조회의 일자 및 시간

SQL 질의에 바인드 변수 사용

SQL query에서 바인드 변수를 사용하여 런타임 시 값을 제공할 수 있습니다. 콜론(:)과 변수 이름을 차례로 사용하여 SQL 문에서 바인드 변수를 정의합니다.

예를 들어, 다음과 같습니다.

SELECT *
FROM employees
WHERE city = :ct;

질의를 실행하면 추가 기능에서 바인드 변수 :ct에 대한 값을 입력하라는 메시지를 표시합니다. 값을 제공한 후(예: Austin) 해당 값을 사용하여 질의가 실행됩니다. 결과와 함께 표시되는 질의 정보에는 바인드 변수 지정(예: :ct=Austin)이 포함됩니다.

한 query에 여러 바인드 변수를 포함할 수 있습니다. 추가 기능은 각 바인드 변수에 대해 최근에 사용된 값을 보유합니다. 조회를 다시 실행할 때 최근 값을 선택하거나 새 값을 입력할 수 있습니다. 질의 매개변수 대화상자에서 이전에 저장된 값을 지울 수도 있습니다.

질의 결과 새로고침

질의 새로고침을 사용하여 직접 SQL, 데이터 분석 또는 자연어 패널을 열지 않고도 저장된 질의를 재실행하고 워크시트에서 결과를 업데이트할 수 있습니다.

질의 결과를 새로 고치려면 다음을 수행합니다.

  1. 스프레드시트 추가 기능에서 생성된 질의 결과가 포함된 워크시트를 선택합니다.

  2. 쿼리 새로고침을 누릅니다.

    추가 기능은 저장된 질의를 재실행하고 현재 워크시트를 최신 결과로 업데이트합니다.

워크북에 새로 고칠 수 있는 질의 결과가 있는 추가 워크시트가 포함된 경우 추가 기능에는 나머지 워크시트 수가 표시되고 새로 고치라는 메시지가 표시됩니다. 새로고침이 완료된 후 추가 기능에는 성공적으로 새로고침된 워크시트를 나타내는 보고서가 표시되고 새로 고칠 수 없는 워크시트를 식별합니다.

주:

해당 데이터베이스 연결이 저장되고 연결된 경우 워크시트를 새로 고칠 수 있습니다. 스프레드시트 추가 기능은 해당 접속이 활성 접속이 아닌 경우에도 저장된 접속 정보를 사용하여 각 워크시트를 새로 고칩니다.

다음과 같은 시나리오에서 Refresh 작업을 실패할 수 있습니다.

  • 저장된 시각화가 질의에서 반환된 열과 더 이상 일치하지 않습니다.

  • 데이터베이스 URL 및 워크시트와 연관된 사용자와 일치하는 저장된 연결이 없습니다.

  • 필요한 데이터베이스 접속이 해제되었습니다.

새로고침 보고서는 실패한 워크시트에 대한 세부정보를 제공합니다. 원인에 따라 질의 또는 시각화를 업데이트하거나, 일치하는 저장된 접속을 추가 또는 임포트하거나, 다시 새로고침하기 전에 필요한 데이터베이스 접속을 다시 접속할 수 있습니다.

대용량 데이터 처리

10,000개가 넘는 레코드가 포함된 결과와 같이 큰 데이터 집합이 있는 질의의 경우 전체 결과를 확인하려는 경우 추가 기능에 확인용 창이 표시됩니다.

주:

피벗 테이블로 작업하는 동안 통합에서 정확한 결과를 얻기 위해 전체 데이터를 로드합니다.

상위 항목: 스프레드시트 추가 기능 사용