Snowflake Connector for SharePoint 설정하기

참고

|SharePoint|에는 `커넥터 약관<https://www.snowflake.com/legal/snowflake-connector-terms/>`_이 적용됩니다.

중요

SharePoint용 Snowflake Connector에 관심을 가져주셔서 감사합니다. 당사에서는 현재 대폭 개선된 환경을 제공할 차세대 솔루션에 집중하고 있습니다. 따라서 이 커넥터를 일반 공급 상태로 전환하는 것은 현재 제품 로드맵에 포함되어 있지 않습니다. 이 커넥터를 미리 보기 기능으로 계속 사용할 수 있지만, 향후 버그 수정 및 개선 사항에 대한 지원은 보장되지 않습니다. 새 솔루션은 :doc:`SharePoint용 Openflow Connector</user-guide/data-integration/openflow/connectors/sharepoint/about>`로 제공되며, 여기에는 더 나은 성능, 사용자 지정 기능, 향상된 배포 옵션이 포함됩니다.

이 항목에서는 |SharePoint|를 설정하는 단계를 설명합니다.

전제 조건

커넥터 설치 및 구성을 시작하기 전에 다음을 수행해야 합니다.

  1. `Microsoft Graph<https://learn.microsoft.com/en-us/graph/overview>`_ 애플리케이션에 다음 권한이 있는지 확인합니다.

  2. `사용자 없이 액세스 권한 얻기<https://learn.microsoft.com/en-us/graph/auth-v2-service?tabs=http#authentication-and-authorization-steps>`_에 설명된 대로 OAuth 인증을 활성화하도록 SharePoint를 구성합니다. 커넥터는 다음 Microsoft Graph APIs를 사용하여 SharePoint에서 데이터를 가져옵니다.

  3. Snowflake로 수집하려는 파일 또는 폴더가 있는 Microsoft 365 SharePoint 사이트 URL 및 Azure 또는 Office 365 계정 관리자로부터 자격 증명을 받습니다.

Snowflake Connector for SharePoint 설치

커넥터는 Snowflake 네이티브 애플리케이션의 인스턴스입니다. |SharePoint|를 설치하려면 다음을 수행합니다.

  1. ACCOUNTADMIN 역할의 사용자로 Snowflake에 로그인합니다.

  2. Data Products » Marketplace 으로 이동합니다.

  3. |SharePoint|를 검색하고 :ui:`Get`을 선택합니다.

  4. 대화 상자에서 :ui:`Options`를 확장하고 다음 정보를 입력합니다.

    • :ui:`Application name`에 커넥터 애플리케이션의 이름을 입력합니다.

    • :ui:`Warehouse used for installation`에서 커넥터 설치에 사용할 웨어하우스를 선택합니다.

      참고

      이것은 커넥터가 SharePoint에서 데이터를 동기화하는 데 사용하는 것과 동일한 웨어하우스가 아닙니다. 이후 단계에서 이 목적으로 별도의 웨어하우스를 생성합니다.

  5. 설치 프로세스를 시작하려면 :ui:`Get`을 선택합니다. 이 작업을 완료하는 데 몇 분 정도 걸릴 수 있습니다.

  6. 커넥터가 설치되면 :ui:`Configure`를 선택하여 :ref:`구성<label-configure_sharepoint_connector>`을 진행하거나 :ui:`Done`을 선택하여 대화 상자를 닫고 설치를 완료합니다.

선택 사항: |SharePoint|의 여러 인스턴스 설치

Snowflake 계정에 Snowflake Connector for SharePoint 의 여러 인스턴스를 설치할 수 있습니다. 추가 인스턴스를 설치하려면 다음을 수행합니다.

  1. Snowflake Marketplace로 이동하여 |SharePoint|를 선택합니다. 애플리케이션 세부 정보 페이지가 나타납니다.

  2. Add instance 를 클릭합니다. 설치 대화 상자가 나타납니다.

  3. 인스턴스 이름을 입력하고 설치 중에 사용할 웨어하우스를 선택합니다.

  4. 설치 프로세스를 시작하려면 :ui:`Get`을 선택합니다.

참고

  • 커넥터 인스턴스 추가에 몇 분이 걸릴 수 있습니다. 설치 과정이 완료되면 이메일 알림을 받게 됩니다.

  • 수집된 데이터 손상을 방지하려면 커넥터 구성 중에 항상 다른 모든 네이티브 애플리케이션과 상이한 데이터베이스 스키마를 사용합니다.

Snowflake Connector for SharePoint 구성

각 커넥터 애플리케이션 인스턴스는 연결된 Sharepoint 인스턴스와 통신하도록 구성해야 합니다. :ref:`설치 프로세스<label-install_sharepoint_connector>`를 완료한 후 다음 단계를 진행합니다.

  1. 모든 전제 조건이 완료되었는지 확인합니다. 자세한 내용은 전제 조건 섹션을 참조하세요.

  2. 필요한 경우 다음과 같이 구성 마법사를 엽니다.

    1. ACCOUNTADMIN 역할을 가진 사용자로 Snowsight 에 로그인합니다.

    2. 탐색 메뉴에서 Data Products » Apps 를 선택합니다.

    3. |SharePoint|를 검색하고 선택합니다.

구성

  1. 마법사의 Configure 단계에서 다음 필드에 정보를 입력합니다.

참고

기본적으로, 필드는 커넥터를 구성할 때 생성되는 오브젝트의 이름으로 설정됩니다. 이러한 필드에 새 오브젝트를 사용하는 것이 좋습니다. 그러나 필요한 경우 기존 오브젝트의 이름을 지정할 수 있습니다(예: 커넥터를 다시 설치하는 경우).

필드

설명

Warehouse for Ingestion Data

커넥터에 대한 새로운 전용 가상 웨어하우스의 식별자입니다. 이 웨어하우스는 데이터 수집 및 문서 처리 작업을 계산하는 데 사용됩니다.

계정에 고유한 이름을 지정하십시오. 웨어하우스 이름은 유효한 :doc:`오브젝트 식별자</sql-reference/identifiers-syntax>`여야 합니다.

또는 기존 웨어하우스를 선택할 수도 있습니다.

참고

커넥터를 처음 생성할 때 사용한 웨어하우스는 지정하지 마세요.

Warehouse for Cortex Search:

새로운 전용 Cortex Search 가상 웨어하우스의 식별자입니다. 이 웨어하우스는 Cortex Search 쿼리를 처리하고 제공하는 데 사용됩니다.

계정에 고유한 이름을 지정하십시오. 웨어하우스 이름은 유효한 :doc:`오브젝트 식별자</sql-reference/identifiers-syntax>`여야 합니다.

참고

커넥터 설치 시작 시 선택한 것과 동일한 웨어하우스를 지정하지 마십시오. 구성 프로세스에서는 지정된 이름으로 새 X-Small 웨어하우스를 생성합니다.

Role for Cortex Search

커넥터에 대한 새로운 사용자 지정 역할의 식별자입니다. 계정에 고유한 이름을 지정하십시오. 역할 이름은 유효한 :doc:`오브젝트 식별자</sql-reference/identifiers-syntax>`여야 합니다.

역할을 부여한 사용자는 자신의 계정을 사용하여 애플리케이션에서 수집한 데이터에 대해 Cortex REST API를 쿼리할 수 있습니다. 기본적으로, 커넥터를 설치하는 데 사용한 계정에만 Cortex를 쿼리할 수 있는 권한이 있습니다.

  1. 계속하려면 :ui:`Configure`를 클릭합니다.

Sharepoint 인증 및 연결

중요

브라우저에서 팝업이 활성화되어 있는지 확인합니다.

  1. 마법사의 Authentication 단계에서 다음 정보와 자격 증명을 입력하여 OAuth2 인증을 완료하고 SharePoint에 연결합니다.

    이 정보는 Azure 또는 Office 365 계정 관리자에게 문의하세요.

    필드

    설명

    SharePoint site URL

    커넥터가 콘텐츠를 수집할 URL 또는 Sharepoint 사이트입니다.

    최상위 사이트의 경우 도메인 이름만 사용합니다(예: sitename.sharepoint.com). 하위 사이트의 경우 사이트 경로와 함께 도메인 이름을 사용합니다(예: sitename.sharepoint.com/sites/SubSite).

    Client ID

    클라이언트 ID를 입력합니다. 클라이언트 ID 및 Microsoft Entra에서 클라이언트 ID를 찾는 방법을 알아보려면 `애플리케이션 ID(클라이언트 ID)<https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application#application-id-client-id>`_를 참조하세요.

    Client secret

    클라이언트 시크릿을 입력합니다. 클라이언트 시크릿 및 Microsoft Entra에서 클라이언트 시크릿을 찾는 방법에 대해 알아보려면 `인증서 및 시크릿<https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application#certificates–secrets>`_을 참조하세요.

    Tenant ID

    테넌트 ID를 입력합니다. 테넌트 ID 및 Microsoft Entra에서 테넌트 ID를 찾는 방법을 알아보려면 `Microsoft 365 테넌트 ID 찾기<https://learn.microsoft.com/en-us/sharepoint/find-your-office-365-tenant-id>`_를 참조하세요.

  2. :ui:`Next`를 클릭하여 연결 프로세스를 시작합니다. 이 작업을 완료하는 데 몇 분 정도 걸릴 수 있습니다.

원본 검증하기

마법사의 Validate source 단계에서 다음을 수행합니다.

  1. 파일을 가져올 소스를 선택합니다.

    • :ref:`label-connect_to_sharepoint`에서 제공한 자격 증명을 통해 액세스할 수 있는 모든 폴더에서 파일을 가져오려는 경우 :ui:`All folders`를 선택합니다.

    • :ref:`label-connect_to_sharepoint`에서 제공한 자격 증명을 통해 액세스할 수 있는 특정 폴더에서 파일을 가져오려는 경우 :ui:`Specific folder`를 선택합니다.

      참고

      이 경로는 공유 문서 폴더를 기준으로 합니다. 예를 들어, 폴더 ``Shared%20Documents/user_manuals/cars``에서 파일을 수집하려면 ``user_manuals/cars``를 입력합니다.

    참고

    나중에 가져오기 파일 소스를 변경하려면 커넥터를 다시 설치해야 합니다.

  2. :ui:`Validate`를 클릭하여 소스 유효성 검사 프로세스를 시작합니다. 이 작업은 몇 분 정도 걸릴 수 있습니다.

  3. 커넥터가 구성되면 :ui:`Ingest files`를 클릭하여 데이터 수집을 시작합니다.

다음 단계

커넥터가 설정되면 :doc:`cortex`로 계속 진행합니다.