연결 내보내기 및 가져오기

정상 동작

서버, 데이터베이스, 로그인(비밀번호 포함 여부 선택)과 레이블 색상, 아이콘까지 하나의 파일에 담아 다른 컴퓨터로 옮기고, 포함할 항목을 정밀하게 고르세요.

A 연결 파일 한 번에 전체 작업 설정을 컴퓨터 간 또는 팀원 간에 옮깁니다: 서버, 그 위의 데이터베이스, 사용할 로그인, 선택한 경우 비밀번호까지, 해당 연결이 속한 클라이언트, 프로젝트, 환경 레이블과 각 레이블의 색상 그리고 아이콘. 두 내보내기는 같은 파일을 만들며, 유일한 차이는 비밀번호가 들어 있느냐입니다. SQLly에서 내보내거나 팀 세팅용으로 직접 작성한 다음, 어느 SQLly 사본에서든 가져올 수 있습니다.

비밀번호가 포함된 파일은 비밀번호를 평문으로 저장합니다. 그래서 유용하고, 그래서 민감합니다. SQLly는 내보낸 파일을 사용자만 읽을 수 있게 저장하고, 가져올 때 모든 비밀번호를 시스템 키체인으로 옮기며, 파일 사본은 절대 보관하지 않습니다. 신뢰할 수 있는 채널로 보내고, 가져온 뒤에는 삭제하세요. 연결을 공유하려면 없이 비밀번호라면 다음을 쓰세요 파일 → 연결 내보내기….

연결 내보내기

선택 파일 → 연결 내보내기… 비밀번호가 없는 파일에 쓰거나, 아니면 파일 → 연결 내보내기(자격 증명 포함)… 그것들이 붙은 연결 하나를 고를 때는(둘 다 명령 팔레트에도 있습니다). 어느 쪽이든 저장된 연결 전부를 트리로 보여 주는 선택기가 열립니다: 각 서버 (호스트, 포트, 엔진)과 함께 데이터베이스 를 보여 주고, 그 아래 저장해 둔 것들까지 내려갑니다. Export Conn w/ Creds를 열면 파일에 비밀번호가 평문으로 담긴다는 경고가 맨 위에 표시됩니다.

  • 서버를 일부 또는 전체 선택 - 서버를 체크하면 그 아래의 모든 데이터베이스가 선택되며, 다시 체크하면 선택이 해제됩니다.
  • 일부 또는 전체 데이터베이스 선택 - 서버를 펼쳐 개별 데이터베이스를 체크하면, 서버 행에 그중 몇 개가 선택됐는지 표시됩니다.
  • 모두 선택 / 모두 해제 모든 항목을 한 번에 토글합니다. 모든 항목은 처음에 선택되어 있습니다.
  • 선택한 항목만 포함됩니다 - 선택한 연결에 사용되는 공유 로그인, 터널 프로필, 클라이언트, 프로젝트, 환경 레이블이 포함되며, 다른 것은 포함되지 않습니다.

클릭 내보내기 그리고 저장 위치를 선택합니다. 연결 편집기가 제공하는 모든 설정은 연결의 로그인 방식까지 포함하여 항상 함께 저장됩니다. 자격 증명이 있는 경우, SQLly는 각 비밀번호, 암호 구문, 토큰을 키체인에서 파일로 다시 읽어옵니다; 자격 증명이 없는 경우 모든 비밀은 생략되며 SQLly는 저장하기 전에 파일에 비밀이 없는지 확인합니다. 여러 내보낸 연결에서 사용되는 로그인은 공유 로그인으로 한 번만 기록되며, 하나의 연결에서만 사용되는 로그인은 해당 연결에 기록됩니다. 레이블 아이콘은 파일에 내장되어 있어 파일 자체만으로도 완전합니다.

SQLly
비밀번호 포함 여부와 대상 파일을 선택할 수 있는 SQLLY Export 연결 내보내기 대화 상자비밀번호 포함 여부와 대상 파일을 선택할 수 있는 SQLLY Export 연결 내보내기 대화 상자
연결 내보내기 대화 상자: 비밀번호 포함 여부를 고른 뒤 파일을 고릅니다.

연결 가져오기

선택 파일 → 연결 가져오기… 그리고 파일을 선택하세요. 같은 명령으로 비밀번호가 있든 없든 파일을, 그리고 예전 버전 SQLly의 Export Connections가 저장한 파일도 읽을 수 있습니다. 무엇을 바꾸기 전에 파일 전체를 검사해서, 잘못된 항목이 하나라도 있으면 문제를 전부 나열하고 아무것도 가져오지 않으므로 절반만 적용된 가져오기는 일어날 수 없습니다. 잘못 입력한 설정 이름은 조용히 건너뛰는 대신 알려줍니다. 가져온 연결은 서버 탐색기에 바로 나타납니다.

  • 비밀번호는 키체인에 저장됩니다 - macOS에서는 Keychain, Windows에서는 Credential Manager, Linux에서는 Secret Service로 저장 - SQLly의 연결 저장 파일에는 절대 들어가지 않습니다. 상태 표시줄에 몇 개를 가져왔는지 표시됩니다.
  • 라벨은 이름 기준으로 병합됩니다. - 기존 클라이언트·프로젝트·환경은 파일이 정하지 않은 것은 그대로 두고, 파일에 적힌 안전 스위치만 바뀝니다.
  • 공유 로그인은 그 자리에서 업데이트됩니다. - 같은 이름과 사용자 이름의 저장된 로그인에는 새 비밀번호가 적용되므로, 그 로그인을 쓰던 연결은 전부 그대로 동작합니다.
  • 비밀번호 없으면 문제 없음 - 비밀번호 없는 로그인(자격 증명 없이 내보낸 파일이라면 모든 로그인)도 그대로 가져오며, 처음 연결할 때 SQLly가 비밀번호를 물어봅니다.

Redis Insight에서 가져오기

Redis Insight에서 데이터베이스를 선택하고 다음을 선택하세요 내보내기 (체크 비밀번호 포함 까지 옮기고 싶다면 말이죠). SQLly에서는 다른 도구에서 가져오기… 내보낸 파일, 일반 JSON 또는 Redis Insight가 허용하는 base64 형식을 선택하세요. 각 데이터베이스는 호스트, 포트, 논리적 데이터베이스, ACL 사용자 이름, SSH 터널 및 TLS 설정과 함께 Redis 연결이 됩니다.

  • TLS는 절대 해제되지 않음 - TLS로 내보낸 데이터베이스(CA 또는 클라이언트 인증서 포함)는 암호화된 채로 가져옵니다: CA 검증 Redis Insight가 서버 인증서를 검증했을 때, 필수 검증하지 않았을 때입니다. 인증서와 키 내용은 SQLly 데이터 폴더에 PEM 파일로 저장되고(키는 본인만 읽을 수 있음) 연결이 그 파일을 가리킵니다.
  • 비밀 정보는 키체인에 저장됩니다 - 내보내기에 담긴 암호, SSH 암호, 키 암호문구는 연결 파일과 똑같이 취급되어 저장 연결 파일에는 절대 들어가지 않습니다. 내보낸 파일은 확인 후 지우세요. 평문으로 담고 있으니까요.
  • Azure Entra 데이터베이스 Microsoft Entra 로그인으로 가져오기; 연결 편집기에서 Azure 계정을 선택하세요.
  • 클러스터 데이터베이스 이름으로 지정한 노드를 기준으로 Redis 클러스터 연결로 가져오기(또는 Redis Insight가 독립형으로 강제하도록 설정된 경우 하나의 노드로 가져오기). Sentinel 데이터베이스는 마스터 그룹, 센티널 비밀번호(키체인으로 이동), 마스터 자체의 로그인 정보와 함께 Sentinel 연결로 가져와지며, 가져오지 못한 항목은 상태 표시줄에 표시됩니다.

연결 파일이 담을 수 있는 것

섹션담고 있는 내용
연결서버는 몇 개든, 서버마다 데이터베이스도 몇 개든: 엔진, 호스트, 포트, 데이터베이스, 환경, 클라이언트와 프로젝트, 로그인 방식과 (자격 증명 저장 시) 비밀번호, TLS 모드와 인증서 파일, 연결 및 구문 시간 제한, 애플리케이션 이름, 시작 SQL, 연결별 안전 스위치, 즐겨찾기 별표, 마스킹 규칙, 릴레이 경로, 그리고 인라인 SSH 터널, 프록시 또는 Kubernetes 포트 포워딩.
공유 로그인여러 연결이 공유할 수 있는 이름 있는 로그인 여러 개(사용자 이름과 자격 증명 파일에 담긴 비밀번호).
터널 프로필이름을 지정한 SSH(점프 호스트 포함), 프록시, Kubernetes 체인과 자격 증명 파일에 저장되는 SSH 비밀번호 및 키 패스프레이즈.
클라이언트, 프로젝트, 환경이름, 색상, 아이콘 이미지(파일에 포함)와 모든 쿼리 보호 기능.

SQLly가 지원하는 모든 로그인 방식은 기록할 수 있습니다: 사용자 이름과 비밀번호, Windows 통합 인증, Microsoft Entra(브라우저 또는 디바이스 코드), AWS RDS IAM, Google Cloud SQL IAM, libSQL / Turso 토큰. SQLite와 DuckDB 파일은 로그인이 필요 없습니다.

직접 하나씩 쓰기

연결 파일은 일반 JSON이라 관리자가 직접 작성해 팀에 바로 쓸 수 있는 설정을 건넬 수 있습니다. 다만 연결의 name, engine, 그리고 server 뿐이며, 나머지는 연결 편집기가 채워 주는 것과 같은 기본값으로 처리됩니다. 이 파일에는 읽기 전용 로그인을 공유하는 한 서버의 데이터베이스 두 개, 비밀번호가 별도인 두 번째 서버, 아이콘이 있는 컬러 클라이언트가 추가됩니다:

{
  "format": "sqlly-credentials",
  "version": 1,
  "clients": [
    { "name": "Acme", "color": "#1E88E5", "image": "data:image/png;base64,iVBORw0KGgo…" }
  ],
  "sql_auth_accounts": [
    { "name": "Reader", "username": "ro", "password": "ro-secret" }
  ],
  "connections": [
    { "name": "Sales", "engine": "postgresql", "server": "pg1.acme.internal", "database": "sales",
      "client": "Acme", "environment": "production",
      "authentication": { "type": "sql-login", "account": "Reader" },
      "tls": { "mode": "verify-full" } },
    { "name": "HR", "engine": "postgresql", "server": "pg1.acme.internal", "database": "hr",
      "client": "Acme", "authentication": { "type": "sql-login", "account": "Reader" } },
    { "name": "Ops", "engine": "sql-server", "server": "sql01.acme.internal", "database": "ops",
      "authentication": { "type": "sql-login", "username": "ops", "password": "ops-secret" } }
  ]
}
  • 엔진 느슨하게 쓸 수도 있습니다 - postgres, PostgreSQL, mssql, sql-server, mysql, sqlite, duckdb, clickhouse, redis등등.
  • 색상 은 #RGB, #RRGGBB, 또는 #RRGGBBAA.
  • 아이콘 은 base64입니다 - data:image/…;base64, URI 또는 순수 base64 — PNG, JPEG, GIF, WebP, BMP, ICO 또는 SVG 이미지(최대 1MB).
  • 환경 은 local, dev, test, staging, 또는 production.

사전 구성된 연결(Docker, Kubernetes, 관리형 머신)

파일을 한 번만 가져오는 대신, SQLly가 연결을 프로비저닝 연결을 시작할 때마다 다시 엽니다 - 데스크톱 앱에서도, sqlly-cli 에이전트 명령 및 자체 호스팅 환경에서 sqlly-bridge embedded 서버입니다. 가리킬 대상은 다음 SQLLY_PROVISIONED_CONNECTIONS_FILE 파일로 지정하거나 (다음을 넣거나 provisioned-connections.json SQLly 설정 폴더에 있고, 옆에는 connections.json), 그리고/또는 하나를 지정 SQLLY_CONNECTION_<NAME> 연결마다 자기 URL을 담는 변수입니다. 파일은 위의 연결 파일 형식을 사용합니다 (format 그리고 version 생략될 수 있으며, 오직 connections 을(를) 읽음), 그리고 어떤 연결이든 다음을 줄 수 있습니다 url 엔진, 서버, 포트, 데이터베이스, 로그인 필드 대신:

{
  "connections": [
    { "name": "Cache",
      "url": "redis+sentinel://app:${REDIS_PASSWORD}@sentinel-0:26379,sentinel-1:26379/mymaster/0?sentinelPassword=${SENTINEL_PASSWORD}",
      "environment": "production" },
    { "name": "Orders", "engine": "postgres", "server": "${PGHOST}", "database": "orders",
      "authentication": { "type": "sql-login", "username": "app", "password": "${PGPASSWORD}" },
      "tls": { "mode": "verify-full" } }
  ]
}
# docker run / Kubernetes env
SQLLY_PROVISIONED_CONNECTIONS_FILE=/etc/sqlly/connections.json
REDIS_PASSWORD=...        # from a Secret
SENTINEL_PASSWORD=...
SQLLY_CONNECTION_SESSIONS=rediss+sentinel://:${REDIS_PASSWORD}@sentinel-0,sentinel-1/sessions
  • Sentinel URL - redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>], 다음과 함께 rediss+sentinel:// TLS와 valkey+sentinel:// / valkeys+sentinel:// Valkey용입니다. ?sentinelPassword= 센티넬 자신의 비밀번호를 설정하고 ?preferReplica=true 읽기 전용 스크립트를 복제본에 보냅니다. 포트가 없는 센티널은 26379를 씁니다. 같은 URL을 연결 편집기의 URL 붙여넣기에서도 쓸 수 있습니다.
  • ${VARIABLE} 파일 내 어디에서든(또는 SQLLY_CONNECTION_ URL)은 해당 환경 변수로 대체됩니다; 리터럴로 쓰려면 $${ 는 문자 그대로의 ${.
  • 비밀번호는 파일에 포함되지 않습니다 - 비밀번호, 토큰, redis_sentinel_password, URL 비밀번호, 또는 sentinelPassword 정확히 다음과 같이 표기되었습니다. ${VARIABLE} SQLly가 연결될 때마다 환경에서 읽히며, 프로필에 복사되거나 어디에도 저장되지 않습니다.
  • 관리형, 읽기 전용 - 발급된 연결은 내 연결들과 나란히 보이지만 절대 connections.json, 그리고 저장과 삭제는 이들에 대해 거부됩니다: 대신 파일이나 변수를 변경하거나 다음을 사용하세요 복제 를 누르면 편집 가능한 나만의 사본이 만들어집니다.
  • 잘못된 항목 하나가 나머지를 막지 않습니다 - 모르는 설정, 값이 없는 변수, 읽을 수 없는 URL이 있으면 그 연결만 건너뛰고 무엇이 왜 그런지 경고로 알려 줍니다. 이름이 이미 쓰인 연결이 뒤에 나오면 마찬가지로 건너뜁니다.
  • 브리지에서 - sqlly-bridge embedded 해당 사용자를 읽기 전용 프로필로 취급합니다 provisioned (다음을 통해서도 --provisioned-connections <file>); 실행 토큰은 다른 프로필과 마찬가지로 이 프로필을 지정할 수 있으며, 상태 디렉터리에는 절대 기록되지 않습니다.