> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Databricks 커넥터

> Replit Agent가 Databricks 워크스페이스를 기반으로 데이터 기반 애플리케이션을 구축할 수 있도록 Databricks 커넥터를 설정하세요.

<Info>
  Databricks 커넥터는 **Enterprise** 플랜에서만 사용 가능합니다.
</Info>

<Frame>
  <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/templates-dropdown-zoom.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=92d2df97ba167b7fd5b9dfe7509e7dfa" alt="Databricks 앱 조직 템플릿이 표시된 Templates 드롭다운이 열린 Replit 홈 프롬프트 박스" width="1680" height="300" data-path="images/connectors/databricks/templates-dropdown-zoom.png" />
</Frame>

Databricks 커넥터를 사용하면 Replit Agent가 Databricks 워크스페이스를 쿼리할 수 있습니다. 빌더는 자연어를 사용하여 대시보드, 보고 도구 및 데이터 애플리케이션을 만들 수 있습니다. SQL 전문 지식이 필요하지 않습니다.

설정은 Databricks 관리자와 Replit 조직 관리자가 관여하는 일회성 프로세스입니다. 구성이 완료되면 접근 권한이 있는 빌더는 Replit에서 커넥터를 사용할 수 있습니다.

이 가이드는 세 가지 역할에 걸친 전체 설정을 다룹니다:

1. **Databricks 관리자**: Databricks에서 서비스 주체를 만들고 권한을 부여합니다.
2. **Replit 관리자**: Replit에서 커넥터를 구성합니다.
3. **빌더**: Databricks 데이터로 구축을 시작합니다.

## 사전 요구 사항

시작하기 전에 다음을 확인하세요.

**역할**

* [Databricks](https://www.databricks.com/) 계정 관리자 또는 워크스페이스 관리자
* [Replit](https://replit.com/) 조직 관리자

## 1단계: Databricks에서 서비스 주체 만들기

<Note>
  이 단계를 완료하려면 Databricks 계정 관리자 또는 워크스페이스 관리자여야 합니다.
</Note>

Databricks 관리자는 Replit이 Databricks에 연결하는 데 사용하는 [서비스 주체](https://docs.databricks.com/aws/en/admin/users-groups/service-principals)라는 머신 간 ID를 만듭니다.

<Steps>
  <Step title="설정 열기">
    Databricks에서 오른쪽 상단의 아바타를 선택한 다음 **설정**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/settings-menu.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=4179d36f68585cf88af24ab86d960694" alt="설정이 선택된 Databricks 워크스페이스 메뉴" width="3438" height="1984" data-path="images/connectors/databricks/settings-menu.png" />
    </Frame>
  </Step>

  <Step title="ID 및 접근 선택">
    설정 사이드바에서 **ID 및 접근**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/settings-page.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=8e22324831c8804b135a3b5e550e7f45" alt="사이드바에 ID 및 접근이 있는 Databricks 설정 페이지" width="3438" height="1984" data-path="images/connectors/databricks/settings-page.png" />
    </Frame>
  </Step>

  <Step title="서비스 주체 관리">
    **관리 및 권한** 아래에서 **서비스 주체**를 찾아 **관리**를 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/identity-and-access.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=4c502716a573596cbe0550644036654d" alt="서비스 주체 관리 버튼이 표시된 ID 및 접근 설정 페이지" width="3438" height="1984" data-path="images/connectors/databricks/identity-and-access.png" />
    </Frame>
  </Step>

  <Step title="새 서비스 주체 추가">
    **서비스 주체 추가**를 선택한 다음 **새로 추가**를 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/add-service-principal.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ca1c2ec068049bd48b2c590d9cae4b3f" alt="새로 추가 버튼이 있는 서비스 주체 추가 대화 상자" width="3438" height="1984" data-path="images/connectors/databricks/add-service-principal.png" />
    </Frame>
  </Step>

  <Step title="서비스 주체 이름 지정">
    서비스 주체의 명확한 이름을 입력한 다음 **추가**를 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/add-service-principal-name.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f2490e64e7bb1516e153f7690da5c9a2" alt="서비스 주체 이름이 입력된 서비스 주체 추가 대화 상자" width="3438" height="1984" data-path="images/connectors/databricks/add-service-principal-name.png" />
    </Frame>
  </Step>

  <Step title="서비스 주체 세부 정보 확인">
    Databricks가 서비스 주체를 만든 후 활성 상태인지 확인합니다. Replit 커넥터를 구성하는 동안 서비스 주체 세부 정보가 필요한 경우 이 페이지를 열어 두세요.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/service-principal-details.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ffdb270b49e7b6a330c3691358b8234b" alt="Databricks 서비스 주체 세부 정보 페이지" width="3438" height="1984" data-path="images/connectors/databricks/service-principal-details.png" />
    </Frame>
  </Step>

  <Step title="접근 권한 부여">
    **권한** 탭을 열고, **접근 권한 부여**를 선택하고, 서비스 주체를 선택하고, 권한을 **관리**로 설정한 다음 **저장**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/grant-access.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=ee85ab8f1741b86f830efcd80427a596" alt="관리 권한이 선택된 Databricks 서비스 주체 접근 권한 부여 대화 상자" width="3438" height="1984" data-path="images/connectors/databricks/grant-access.png" />
    </Frame>
  </Step>
</Steps>

## 2단계: SQL 웨어하우스 연결 세부 정보 가져오기

Replit 커넥터는 올바른 컴퓨팅 리소스로 쿼리를 라우팅하기 위해 Databricks SQL 웨어하우스 연결 세부 정보가 필요합니다.

<Steps>
  <Step title="SQL 웨어하우스 열기">
    Databricks 사이드바에서 **SQL 웨어하우스**를 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/sql-warehouses.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=8610ede28b6a723fd5774fb9e97c7485" alt="사용 가능한 웨어하우스가 표시된 Databricks SQL 웨어하우스 페이지" width="3438" height="1984" data-path="images/connectors/databricks/sql-warehouses.png" />
    </Frame>
  </Step>

  <Step title="웨어하우스 선택 또는 생성">
    Replit Agent가 사용할 SQL 웨어하우스를 선택합니다. 아직 없는 경우 **SQL 웨어하우스 만들기**를 선택하여 새 웨어하우스를 만듭니다.
  </Step>

  <Step title="연결 세부 정보 복사">
    웨어하우스를 열고 **연결 세부 정보**를 선택합니다. **서버 호스트명** 및 **HTTP 경로** 값을 찾습니다. Replit에서 Databricks 커넥터를 만들 때 이 값들이 필요합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connection-details.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=b2e51207eb945f4e9e939caa093c2b23" alt="서버 호스트명과 HTTP 경로가 있는 Databricks SQL 웨어하우스 연결 세부 정보 페이지" width="3438" height="1984" data-path="images/connectors/databricks/connection-details.png" />
    </Frame>
  </Step>
</Steps>

## 3단계: Replit에서 Databricks 커넥터 만들기

<Note>
  커넥터를 구성하려면 Replit 조직 관리자여야 합니다.
</Note>

Replit 관리자는 빌더가 커넥터를 사용할 수 있도록 Replit에 Databricks 연결 세부 정보를 추가합니다.

<Steps>
  <Step title="통합으로 이동">
    조직 홈에서 **통합** 페이지를 엽니다. **커넥터** 아래에서 \*\*Databricks(서비스 주체)\*\*를 찾아 **로그인**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/integrations-databricks-signin.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f3b1558a4d4afc021fd7b2be96004ea7" alt="로그인 버튼이 있는 Databricks(서비스 주체) 커넥터가 표시된 Databricks로 필터링된 Replit 통합 페이지" width="3436" height="1978" data-path="images/connectors/databricks/integrations-databricks-signin.png" />
    </Frame>
  </Step>

  <Step title="연결 확인">
    Replit은 인증을 위해 Databricks로 리디렉션하기 전에 확인 대화 상자를 표시합니다. 세부 정보를 검토하고 **Databricks로 계속**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connect-databricks-intro.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=d1bd23f4bb71d62a555993b106f4596e" alt="OAuth 리디렉션, 데이터 사용 및 권한을 설명하는 Databricks 연결 대화 상자" width="3436" height="1978" data-path="images/connectors/databricks/connect-databricks-intro.png" />
    </Frame>
  </Step>

  <Step title="SQL 웨어하우스 HTTP 경로 입력">
    Databricks SQL 웨어하우스 연결 세부 정보의 **HTTP 경로**를 붙여넣은 다음(예: `/sql/1.0/warehouses/abcdef1234567890`) **다음**을 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connector-http-path.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=c68fa0868bed7dbd56c46f3be3bbc4b3" alt="SQL 웨어하우스 HTTP 경로를 요청하는 Databricks 연결 대화 상자 1/2단계" width="3436" height="1978" data-path="images/connectors/databricks/connector-http-path.png" />
    </Frame>
  </Step>

  <Step title="SQL 웨어하우스 서버 호스트명 입력">
    동일한 연결 세부 정보의 **서버 호스트명**을 붙여넣은 다음(예: `abc-12345678-wxyz.cloud.databricks.com`) **Databricks로 계속**을 선택하여 인증을 완료합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/connector-server-hostname.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=0b8210206a0941725aa1eb71a2b1d99e" alt="SQL 웨어하우스 서버 호스트명을 요청하는 Databricks 연결 대화 상자 2/2단계" width="3436" height="1978" data-path="images/connectors/databricks/connector-server-hostname.png" />
    </Frame>
  </Step>

  <Step title="접근 구성">
    역할 기반 접근 제어를 사용하여 조직의 어떤 구성원이나 그룹이 이 커넥터를 사용할 수 있는지 선택합니다.
  </Step>

  <Step title="커넥터가 활성 상태인지 확인">
    **통합** 페이지로 돌아가 \*\*Databricks(서비스 주체)\*\*가 **활성** 연결 상태로 **커넥터** 아래에 표시되는지 확인합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/integrations-page.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=f2bb0eac84b4d08e7d7213f5aa5e1a9f" alt="활성 연결 상태의 Databricks(서비스 주체) 커넥터가 표시된 Replit 통합 페이지" width="1680" height="1199" data-path="images/connectors/databricks/integrations-page.png" />
    </Frame>
  </Step>
</Steps>

## 4단계: Agent로 구축

연결 후 빌더는 Agent를 사용하여 Databricks 데이터를 활용하는 애플리케이션을 만들 수 있습니다.

<Steps>
  <Step title="프로젝트 시작">
    Replit 홈에서 프롬프트 박스를 열어 새 프로젝트를 시작합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/home-default.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=36baeac209507cbe0cb8a0f5a14a7c5d" alt="프롬프트 박스와 Templates 드롭다운이 있는 Replit 홈 페이지" width="1680" height="1199" data-path="images/connectors/databricks/home-default.png" />
    </Frame>
  </Step>

  <Step title="Databricks 앱 템플릿 선택">
    **Templates** 드롭다운을 열고 **조직 템플릿** 아래에서 **Databricks 앱**을 선택합니다. 프롬프트에는 Agent가 Databricks 커넥터를 사용하는 방법을 알려주는 지침이 미리 채워집니다.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/templates-dropdown.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=707bf8f7247ef849e1064d33dfa09d3a" alt="조직 템플릿 아래에 Databricks 앱 템플릿이 표시된 Templates 드롭다운" width="1680" height="1199" data-path="images/connectors/databricks/templates-dropdown.png" />
    </Frame>

    미리 채워진 지침 뒤에 구축하려는 내용을 설명하는 자체 프롬프트를 추가하세요. 영감을 얻으려면 [Databricks Dev Hub 템플릿](https://www.databricks.com/devhub/templates)을 살펴보세요.

    <Frame>
      <img src="https://mintcdn.com/replit/xfCoeTDIPMvB7evM/images/connectors/databricks/agent-prompt-filled.png?fit=max&auto=format&n=xfCoeTDIPMvB7evM&q=85&s=edc9c3d4e326a265ce3a20dfd5d2bc00" alt="Databricks 앱 템플릿이 선택되고 미리 채워진 지침이 있는 프롬프트 박스" width="1680" height="1199" data-path="images/connectors/databricks/agent-prompt-filled.png" />
    </Frame>
  </Step>

  <Step title="검토 및 반복">
    Agent가 생성한 SQL, 쿼리하는 테이블, 애플리케이션 구조를 검토합니다. 자연어로 변경 사항을 요청하며 반복합니다.
  </Step>
</Steps>

## 문제 해결

<AccordionGroup>
  <Accordion title="서비스 주체 생성 후 인증 실패">
    Replit에 입력된 서비스 주체 세부 정보가 Databricks에서 생성한 서비스 주체와 일치하는지 확인합니다. 자격 증명이 교체된 경우 Replit에서 커넥터를 업데이트하세요.
  </Accordion>

  <Accordion title="Agent가 스키마를 볼 수 있지만 쿼리가 빈 결과를 반환함">
    서비스 주체에 메타데이터 접근 권한은 있지만 데이터에 대한 읽기 권한이 없을 수 있습니다. Databricks에서 필요한 테이블, 스키마 또는 카탈로그 권한을 부여하고 다시 시도하세요.
  </Accordion>

  <Accordion title="커넥터가 SQL 웨어하우스에 연결할 수 없음">
    **서버 호스트명** 및 **HTTP 경로** 값이 Databricks의 SQL 웨어하우스 연결 세부 정보와 일치하는지 확인합니다.
  </Accordion>
</AccordionGroup>

## 관련 문서

* [웨어하우스 커넥터 개요](/connectors/warehouses/overview): 지원되는 모든 웨어하우스 커넥터.
* [Snowflake 연결](/connectors/warehouses/snowflake): 단계별 Snowflake 설정.
* [커넥터 관리](/replitai/managing-connectors): 커넥터 관리 및 구성.
* [Databricks 서비스 주체](https://docs.databricks.com/en/admin/users-groups/service-principals.html): 서비스 주체에 관한 Databricks 문서.
* [Databricks SQL 웨어하우스](https://docs.databricks.com/en/compute/sql-warehouse/index.html): SQL 웨어하우스 컴퓨팅에 관한 Databricks 문서.