Openflow Connector for Excel 설정¶

전제 조건¶

1. Openflow Connector for Excel 정보 을 검토했는지 확인합니다.

2. Openflow를 설정 했는지 확인합니다.

자격 증명 받기¶

이 섹션에서는 커넥터를 구성하기 위해 자격 증명을 얻는 단계에 대해 설명합니다. 데이터 소스에 따라,

• AWS 자격 증명 받기

• SharePoint 자격 증명 받기

Snowflake 계정 설정하기¶

Snowflake 계정 관리자는 다음 작업을 수행합니다.

1. 새 역할을 생성하거나 기존 역할을 사용합니다.

2. 유형이 SERVICE 인 새 Snowflake 서비스 사용자를 생성합니다.

3. Snowflake 서비스 사용자에게 이전 단계에서 생성한 역할을 부여합니다.

4. 2단계의 Snowflake SERVICE 사용자에 대해 키 페어 인증 으로 구성합니다.

5. 적극 권장 AWS, Azure, Hashicorp 등 Openflow에서 지원하는 시크릿 관리자를 구성하고 공개 키와 개인 키를 시크릿 스토어에 저장합니다.

   참고

   시크릿 관리자를 사용하지 않으려면 조직의 보안 정책에 따라 키 페어 인증에 사용되는 공개 키와 개인 키 파일을 보호할 책임이 있습니다.

   1. 시크릿 관리자가 구성되면 인증 방법을 결정합니다. AWS 에서는 다른 시크릿이 유지되지 않도록 Openflow와 연결된 EC2 인스턴스 역할을 사용하는 것이 좋습니다.

   2. Openflow에서 오른쪽 상단의 햄버거 메뉴에서 이 시크릿 관리자와 연결된 Parameter Provider 를 구성합니다. Controller Settings » Parameter Provider 로 이동하여 매개 변수 값을 가져옵니다.

   3. 이 시점에서 모든 자격 증명은 연결된 매개 변수 경로로 참조할 수 있으며 민감한 값은 Openflow 내에서 유지될 필요가 없습니다.

6. 다른 Snowflake 사용자가 커넥터에서 수집한 원시 수집 문서 및 테이블에 대한 액세스가 필요한 경우(예: Snowflake에서 사용자 정의 처리를 위해), 해당 사용자에게 1단계에서 생성한 역할을 부여하십시오.

7. 커넥터가 수집한 데이터를 저장할 수 있도록 Snowflake에서 데이터베이스와 스키마를 생성합니다. 첫 번째 단계에서 생성한 역할에 필수 데이터베이스 권한 를 부여합니다. 역할 자리 표시자를 실제 값으로 바꾸고 다음 SQL 명령을 사용합니다.

   CREATE DATABASE excel_destination_db;
   CREATE SCHEMA excel_destination_db.excel_destination_schema;
   GRANT USAGE ON DATABASE excel_destination_db TO ROLE <excel_connector_role>;
   GRANT USAGE ON SCHEMA excel_destination_db.excel_destination_schema TO ROLE <excel_connector_role>;
   GRANT CREATE TABLE ON SCHEMA excel_destination_db.excel_destination_schema TO ROLE <excel_connector_role>;
   

   Copy

8. 커넥터가 사용할 웨어하우스를 생성하거나 기존 웨어하우스를 사용합니다. 가장 작은 데이터 웨어하우스 크기로 시작한 다음 복제되는 테이블 수와 전송되는 데이터의 양에 따라 크기를 실험해 보십시오. 테이블 수가 많은 경우 일반적으로 더 큰 규모의 웨어하우스보다는 멀티 클러스터 웨어하우스 에서 확장이 더 쉽습니다.

9. 커넥터가 사용하는 역할이 있는 사용자에게 웨어하우스를 사용하는 데 필요한 권한이 있는지 확인합니다. 그렇지 않은 경우 해당 역할에 필수 권한을 충족하는 권한을 부여하십시오.

   CREATE WAREHOUSE excel_connector_warehouse WITH WAREHOUSE_SIZE = 'X-Small';
   GRANT USAGE ON WAREHOUSE excel_connector_warehouse TO ROLE <excel_connector_role>;
   

   Copy

커넥터 설정하기¶

데이터 엔지니어는 다음 작업을 수행하여 커넥터를 설치하고 구성합니다.

플로우 실행¶

1. 평면을 마우스 오른쪽 버튼으로 클릭하고 Enable all Controller Services 를 선택합니다.

2. 가져온 프로세스 그룹을 마우스 오른쪽 버튼으로 클릭하고 Start 를 선택합니다. 커넥터가 데이터 수집을 시작합니다.

생성된 테이블 이름¶

커넥터는 {PREFIX}{FILENAME}_{RANGE} 템플릿을 사용하여 명명된 대상 테이블을 생성합니다. 이름은 항상 큰따옴표로 묶인 식별자 입니다.

• {PREFIX} 는 Destination Table Prefix 매개 변수의 값(예: prfx_)으로 대체됩니다.

• {FILENAME} 은 수집된 파일의 전체 경로(예: file1.xlsx 또는 folder/file2.xlsx)로 대체됩니다.

• {RANGE} 로 대체됩니다.

  • Ranges 매개 변수의 값이 비어 있는 경우 수집된 시트의 이름입니다.

  • Ranges 매개 변수에 지정된 대로 수집된 범위가 있는 수집된 시트의 이름(예: Sheet1!A1:B2)입니다.

생성된 테이블 이름의 예입니다.

• "file1.xlsx_Sheet1"

• "prfx_folder/file2.xlsx_Sheet1!A1:B2"

(선택 사항) 현재 실행 중인 커넥터 재구성하기¶

커넥터가 이미 데이터 수집을 시작한 후에 커넥터 매개 변수를 재구성할 수 있습니다. 수집된 파일 또는 범위를 변경해야 하는 경우 다음 단계를 수행하여 데이터가 Snowflake로 올바르게 전송되는지 확인하십시오.

1. 커넥터 중지: 모든 Openflow 프로세서가 중지되었는지 확인합니다.

2. 구성 설정에 액세스: Openflow 내에서 커넥터의 구성 설정으로 이동합니다.

3. 매개 변수 수정: 필요에 따라 매개 변수를 조정하십시오.

4. 커넥터 시작: 커넥터를 시작하고 모든 컨트롤러 서비스가 시작되었는지 확인합니다.