Databricks에 앱 연결하기

service principal 만들기

Databricks account console에서 User management → Service principals로 이동해 새 service principal을 만듭니다. account console 호스트는 워크스페이스를 어느 클라우드가 호스팅하는지에 따라 다릅니다.

• AWS: accounts.cloud.databricks.com
• Azure: accounts.azuredatabricks.net
• GCP: accounts.gcp.databricks.com

워크스페이스에 할당

account console에서 그대로 Workspaces로 이동해 대상 워크스페이스를 선택하고, Permissions 탭을 연 뒤 Add permissions를 클릭합니다. service principal을 선택하고 Workspace access와 Databricks SQL access 엔타이틀먼트(entitlement)를 부여합니다. 엔타이틀먼트는 나중에 service principal의 Configuration 탭에서 검토하고 변경할 수 있습니다.

SQL warehouse 접근 권한 부여

Databricks 워크스페이스에서 사이드바의 SQL Warehouses를 클릭하고, 앱이 쿼리할 warehouse 행의 케밥 메뉴를 연 뒤 Permissions를 클릭하고, Can use 권한으로 service principal을 추가합니다. Can use 권한이 있으면 service principal이 warehouse를 시작하고 쿼리를 실행할 수 있습니다.

OAuth secret 생성

• Databricks 워크스페이스에서 오른쪽 위 모서리의 사용자 이름을 선택하고 Settings를 선택합니다.
• Identity and access로 이동한 뒤 Service principals를 찾아 Manage를 클릭합니다.
• service principal을 선택하고 Secrets 탭을 엽니다.
• Generate secret을 클릭하고, 만료 기간(최대 730일)을 선택한 뒤 Generate를 클릭합니다.
• Client ID와 Client secret을 즉시 모두 복사하세요. secret은 한 번만 표시됩니다. 이 대화 상자를 닫은 뒤에는 다시 가져올 수 없습니다.

데이터 접근 권한 부여

앱이 읽는 데이터에 Unity Catalog 권한을 부여합니다. principal을 지정할 때는 표시 이름이 아니라 Application ID(이전 단계의 OAuth client ID와 같은 값)를 백틱으로 감싸 사용합니다.

GRANT USE CATALOG ON CATALOG main TO `<application-id>`;
GRANT USE SCHEMA ON SCHEMA main.analytics TO `<application-id>`;
GRANT SELECT ON TABLE main.analytics.orders TO `<application-id>`;

세 가지 권한 부여가 모두 필요합니다. 테이블에 대한 SELECT는 해당 catalog에 대한 USE CATALOG와 schema에 대한 USE SCHEMA 없이는 아무 효과가 없습니다. USE CATALOG는 catalog owner이거나 catalog에 대한 MANAGE 권한이 있는 사람만 부여할 수 있으므로, 그들에게 요청해야 할 수 있습니다. 전체 최소 권한 설정은 연결을 읽기 전용으로 제한하기를 참고하세요.

Workspace URL 확인

Workspace URL은 Databricks에 로그인했을 때 브라우저 주소 표시줄에 나타납니다. Databricks는 이 호스트를 인스턴스 이름이라고 부르며, 형식은 클라우드에 따라 다릅니다.

• AWS: https://dbc-a1b2345c-d6e7.cloud.databricks.com
• Azure: https://adb-5555555555555555.19.azuredatabricks.net. Azure portal에서 워크스페이스 리소스를 선택해 URL 필드를 확인할 수도 있습니다.
• GCP: https://8757561887652360.0.gcp.databricks.com

워크스페이스 객체 식별자 가져오기를 참고하세요.

Databricks 커넥터로 이동

Connectors를 열고 Databricks를 선택합니다.

새 연결 추가

Add connection을 클릭하고 App + chat connector를 선택합니다.

연결 이름 지정

Display name에 연결 이름을 입력합니다 (예: Databricks Engineering 또는 Databricks Sales). service principal의 접근 수준을 반영하는 이름을 사용하세요.

Use your own credentials를 선택한 상태로 두기

Configure connection에서 Use your own credentials를 선택된 상태로 둡니다. 기본값입니다.

자격 증명 입력

1단계: Databricks에서 service principal 구성에서 얻은 값을 사용합니다.

• Workspace URL: Databricks 워크스페이스 URL (예: https://dbc-abc123.cloud.databricks.com)
• Client ID: service principal의 OAuth client ID
• Client secret: service principal의 OAuth client secret

이 연결을 사용할 수 있는 사람 선택

Sharing에서 연결은 기본적으로 본인만 사용할 수 있으며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나, Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.

이 설정은 대부분의 커넥터보다 Databricks에서 더 중요합니다. service principal의 권한 부여가 어떤 데이터가 보일지 결정하기 때문입니다. 여기에 추가한 사람은 누구나 service principal이 접근할 수 있는 모든 것을 쿼리할 수 있습니다. 자세한 내용은 연결과 클라이언트를 사용할 수 있는 사람을 참고하세요.

연결

Connect를 클릭합니다. Lovable이 Databricks 워크스페이스에 대해 자격 증명을 검증합니다.

account console에서 App connections 열기

account admin으로 Databricks account console에 로그인해 사이드바의 Settings를 클릭하고, App connections 탭을 연 뒤 Add connection을 클릭합니다. account console 호스트는 워크스페이스를 어느 클라우드가 호스팅하는지에 따라 다릅니다.

• AWS: accounts.cloud.databricks.com
• Azure: accounts.azuredatabricks.net
• GCP: accounts.gcp.databricks.com

애플리케이션 이름 지정 및 Lovable 리다이렉트 URI 추가

Application name에 Lovable을 식별할 수 있는 이름(예: Lovable)을 입력합니다. Redirect URLs에 다음을 추가합니다.

https://api.lovable.dev/workspaces/connectors/standard/oauth/callback

User OAuth를 선택하면 Lovable 연결 양식이 같은 값을 Redirect URI로 보여주고 복사 버튼도 제공하므로 거기서 복사할 수 있습니다. 값이 정확히 일치해야 합니다.

All APIs 스코프 선택

Access scopes에서 SQL이 아니라 All APIs를 선택합니다. 커넥터는 SQL 실행뿐 아니라 warehouse와 cluster 목록도 조회하므로 Lovable은 로그인 시 all-apis 스코프를 요청합니다. Lovable은 offline_access도 요청하며, 이 스코프가 백그라운드 토큰 갱신을 가능하게 합니다.

토큰 수명 검토

Access token TTL의 기본값은 60분, Refresh token TTL의 기본값은 10080분(7일)입니다. Lovable은 리프레시 토큰이 유효한 동안 액세스 토큰을 자동으로 갱신합니다. 리프레시 토큰이 만료되면 Lovable에서 연결을 다시 연결할 때까지 연결이 동작을 멈추므로, 보안 정책이 허용하고 재연결 횟수를 줄이고 싶다면 리프레시 토큰 TTL을 늘리세요.

client secret 생성 및 값 저장

Generate a client secret을 체크하고 연결을 만듭니다. Databricks가 Connection created 대화 상자에 Client ID와 Client secret을 표시합니다. 두 값을 즉시 복사하세요. secret은 한 번만 표시되며 나중에 다시 가져올 수 없습니다.

체크박스를 해제한 채로 secret 없는 애플리케이션을 만들 수도 있습니다(Databricks는 이를 public client라고 부릅니다). 그러면 Lovable에서도 Client Secret을 비워 둡니다. secret이 있는 애플리케이션이 더 안전한 구성이므로, 특별한 이유가 없다면 secret을 사용하세요.

본인의 Databricks 접근 권한 확인

본인 계정이 앱이 쿼리할 SQL warehouse에 대한 Can use 권한(SQL Warehouses → (해당 warehouse) → 케밥 메뉴 → Permissions)과 데이터에 대한 Unity Catalog 권한, 즉 catalog에 대한 USE CATALOG, schema에 대한 USE SCHEMA, 테이블이나 schema에 대한 SELECT를 갖고 있는지 확인하세요. 세 가지 모두 필수이며, 연결은 정확히 이 권한을 그대로 물려받습니다.

Workspace URL 확인

Workspace URL은 Databricks에 로그인했을 때 브라우저 주소 표시줄에 나타납니다. 예를 들어 AWS에서는 https://dbc-a1b2345c-d6e7.cloud.databricks.com, Azure에서는 https://adb-5555555555555555.19.azuredatabricks.net, GCP에서는 https://8757561887652360.0.gcp.databricks.com 형식입니다. 워크스페이스 객체 식별자 가져오기를 참고하세요.

Databricks 커넥터로 이동

Connectors를 열고 Databricks를 선택합니다.

새 연결 추가

Add connection을 클릭하고 App + chat connector를 선택합니다.

연결 이름 지정

Display name에 연결 이름을 입력합니다. 연결이 본인 자격으로 동작하므로, 본인 이름을 넣은 이름(예: Databricks (Jane))을 쓰면 누구의 접근 권한을 지닌 연결인지 팀원에게 분명해집니다.

User OAuth 선택

Configure connection에서 User OAuth를 선택합니다. 양식이 Databricks OAuth 앱에 추가할 Redirect URI를 보여줍니다. 1단계에서 이 작업을 건너뛰었다면 지금 복사해 앱에 추가하세요.

OAuth 앱 정보 입력

1단계: Databricks에 커스텀 OAuth 애플리케이션 등록에서 얻은 값을 사용합니다.

• Workspace URL: Databricks 워크스페이스 URL (예: https://dbc-abc123.cloud.databricks.com)
• Client ID: 커스텀 OAuth 애플리케이션의 OAuth client ID
• Client Secret: 애플리케이션의 client secret. secret 없는 public client로 만든 경우에만 비워 둡니다

이 연결을 사용할 수 있는 사람 선택

Sharing에서 연결은 기본적으로 본인만 사용할 수 있으며 Private 라벨이 표시됩니다. 공유하려면 Share with others를 클릭합니다. 그런 다음 이메일로 워크스페이스 멤버를 추가하거나, Invite entire workspace를 클릭해 Lovable 워크스페이스의 모든 사람이 연결을 사용할 수 있게 합니다.

자세한 내용은 연결과 클라이언트를 사용할 수 있는 사람을 참고하세요.

연결 및 로그인

Connect를 클릭합니다. Databricks 로그인을 위한 새 창이 열립니다. 브라우저가 창을 차단하면 Lovable이 대신 리다이렉트합니다. Databricks 계정으로 로그인하고 요청된 접근을 승인하세요.