테넌트 범위 지정

정상 동작

멀티테넌트 누락 필터 가드 구성: 실행 여부, 테넌트 열, 테넌트 테이블.

SQLly의 다중 테넌트 구성 필터 누락 가드 현재 데이터베이스에 적용됩니다. 모드는 네 가지입니다: 끄기 (기본값, 테넌트 관련 사항은 표시되지 않음) 허용됨 (테넌트 필터를 인식하고, 절대 귀찮게 하지 않음), 경고 (테넌트 범위 테이블이 테넌트 조건 없이 조회되면 검증 경고가 발생함), 그리고 필수 (그 누락은 차단 오류가 되어 Run이 거부합니다). 이것이 SQLly에게 '테넌트 필터를 잊었다'가 무엇을 의미하는지 가르치는 방법입니다. 내 스키마.

직접 켜기 전까지는 꺼져 있습니다. 모든 데이터베이스는 Off로 시작합니다. 다음 위치에서 그 데이터베이스를 Allowed, Warn, 또는 Required로 고르기 전까지는 테넌트 경고도 실행 차단도 없습니다 도구 › 테넌트 범위 지정. 동일한 기본값이 SQLly가 SQL을 검사하는 모든 곳에 적용됩니다 - 데스크톱 앱, 브라우저 미리보기, 언어 서버, 그리고 명령줄 엔진까지.

테넌트 열을 비워 두면 가드는 일반적인 이름 규칙을 사용합니다 - TenantId, AccountId, OrganizationId, OrgId 그리고 밑줄 표기형들 - 감지 범위를 좁히려면 열 이름을 직접 지정할 수도 있습니다. 원하면 테넌트 테이블 자체를 id와 표시 이름 열과 함께 가리킬 수도 있습니다. 바뀐 내용은 키 입력마다 저장되어 다음 검증에 적용됩니다. 설정은 SQLly의 다른 구성처럼 일반 로컬 파일에 서버·데이터베이스 조합별로 저장됩니다.

재작성기가 아니라 안전장치입니다. 테넌트 범위 지정은 WHERE 절을 주입하거나 SQL을 고치지 않습니다. 적은 내용을 검사할 뿐이며, Required 모드에서도 확인된 테넌트 필터 누락 진단에만 차단하고, 추측으로 막지 않고 그대로 열어 둡니다.
SQLly
SQLly 테넌트 범위 지정 구성SQLly 테넌트 범위 지정 구성
테넌트 범위 지정: 데이터베이스에 가드를 켜고 테넌트 열과 테넌트 테이블을 지정합니다.

SaaS 데이터베이스 설정

  1. 데이터베이스를 마우스 오른쪽 버튼으로 클릭하고 도구 › 테넌트 범위 지정..., 또는 다음을 실행하세요 테넌트 범위 지정 에서 명령 팔레트 연결된 상태로 엽니다. 제목에는 구성 중인 서버와 데이터베이스가 표시됩니다.
  2. 모드를 선택하세요. 버튼 아래 한 줄 설명에서 선택한 모드의 동작을 알 수 있습니다.
  3. 테넌트 열 이름이 관례적인 이름이 아니라고 해 봅시다 - 가령 customer_id - 직접 입력하세요 테넌트 열. 열을 지정하고 나면 그 열만 테이블을 테넌트 범위로 표시합니다.
  4. 다음을 선택적으로 채웁니다 테넌트 테이블. 해당 테넌트 ID 열 그리고 테넌트 표시 이름 열 테이블에 이름을 지정하면 필드가 나타납니다.
  5. 대화 상자를 닫습니다. 저장 버튼이 없습니다; 모든 변경 사항은 이미 저장되었습니다.

가드가 확인하는 것

테이블을 다음으로 간주하는 조건은 테넌트 범위 테넌트 열이 있을 때입니다. 이 테이블을 읽거나 업데이트하거나 삭제하는 문장은 반드시 다음 절 안에서 그 열을 언급해야 합니다 WHERE 또는 JOIN ... ON 조건:

SELECT total FROM dbo.orders;                         -- flagged
SELECT total FROM dbo.orders WHERE tenant_id = 7;  -- fine
SELECT o.total FROM dbo.orders o
JOIN dbo.users u ON o.tenant_id = u.tenant_id;       -- fine

첫 번째 문장은 편집기에서 검증 진단을 받으며, 다음과 같은 메시지가 표시됩니다 `dbo.orders`는 `tenant_id`별로 테넌트 범위가 지정되어 있지만, 이 문장에는 WHERE나 JOIN ON에 `tenant_id` 필터가 없습니다..

  • INSERT는 예외입니다 - 새로운 행은 자체 테넌트 값을 가집니다.
  • 테넌트 레지스트리는 예외입니다 - 기본 키가 테넌트 열인 테이블, 예를 들면 tenants(tenant_id, name), 테넌트 목록이지 테넌트 데이터가 아닙니다.
  • 검사는 조건 안에서 열을 찾을 뿐, 비교하는 값 자체를 판단하지는 않습니다.

네 가지 모드

모드효과
끄기모든 데이터베이스에 적용되는 기본값입니다. 가드는 비활성화되고 테넌트 관련 내용은 표시되지 않습니다. 필드는 숨겨지며, Off는 열이나 테이블 설정을 저장하지 않으므로 Off 상태에서 대화 상자를 닫으면 그 설정이 사라집니다.
허용됨누락된 테넌트 필터에 대한 경고나 오류가 없습니다. 열 및 테이블 설정이 유지됩니다.
경고누락된 필터는 검증 경고이고, 실행은 여전히 동작합니다.
필수누락된 필터는 검증 오류입니다. 실행 버튼을 누르면 배치를 거부하고 메시지를 상태 표시줄에 표시합니다. 여러 대상에서 동시에 실행할 때도 마찬가지입니다.

저장 위치

설정은 서버와 데이터베이스 이름(대소문자 구분 없음)으로 키가 매겨지며, JSON으로 저장되는 파일은 tenant-scoping.json SQLly 애플리케이션 데이터 디렉터리(macOS에서는 ~/Library/Application Support/SQLLY한 번도 구성하지 않은 데이터베이스는 끄기 모드입니다. 브라우저 미리보기는 현재 세션에 대해서만 설정을 유지합니다.

이전 버전에서 업그레이드하시겠습니까? 새 버전이 처음 시작하면 그동안 저장된 테넌트 스코핑 설정을 딱 한 번 모두 지웁니다 - Warn이나 Required로 설정해 둔 데이터베이스도 포함입니다. 데이터베이스에 가드를 다시 적용하려면 테넌트 스코핑을 열어 다시 켜세요.

가드는 테이블이 테넌트 스코핑 대상인지 판단하려면 로드된 스키마 모델의 테이블 열이 필요합니다. 모델이 모르는 테이블은 검사하지 않습니다.