쿼리 매개변수
정상 동작값이 들어갈 곳에는 :id, ? 또는 $1을 작성하고, 결과 위에 값을 입력한 후 SQL을 수정하지 않고 실행하세요.
값이 들어갈 자리에 플레이스홀더를 적고, 결과 위 입력란에 값을 한 번만 입력해 실행하세요. 값을 바꿔 다시 실행해도 스크립트 자체는 그대로라서, 매일 쓰는 쿼리가 저장하고 공유하고 버전 관리에 담을 수 있는 쿼리로 남습니다.
SELECT *
FROM beneficiaries
WHERE id = :id;
편집기에 내용이 담기는 즉시 :id, 매개변수 스트립이 편집기와 결과 사이에 열리고 전용 입력란이 하나 생깁니다. 거기에 42, 다음을 누르고
실행 (Cmd+엔터 / Ctrl+엔터), 그러면 SQLly는 다음을 전송합니다 WHERE id = 42를 전송합니다. SQLly가 연결하는 모든 데이터베이스에서 동일하게 작동합니다.


플레이스홀더 스타일
:name- 모든 엔진에서 이름이 지정된 자리 표시자. 같은 이름을 두 번 사용하면 하나의 입력이 됩니다:
WHERE a.client_id = :client_id OR b.client_id = :client_id. 이름은 대소문자를 구분하지 않으므로:ID그리고:id값을 공유합니다. ?- 위치 기반 자리 표시자로, PostgreSQL을 제외한 모든 엔진에서 사용합니다(PostgreSQL에서 다음은
?JSON 연산자입니다). 스트립에서는 이를 다음과 같이 나열합니다?1,?2…를 스크립트에 나오는 순서대로 나열하고, 명령문을 하나만 실행할 때도 그 번호를 유지합니다. SQLite의 번호 형식,?3, 자기 번호를 유지합니다. $1- PostgreSQL과 DuckDB가 쓰는 번호 자리 표시자.
$1두 번 사용된 것은 하나의 입력입니다. @name- SQL Server 고유의 매개변수 방식입니다. 선언되지 않은
@name스크립트가 선언하지 않은 것으로, 예를 들면WHERE CustomerID = @CustomerId, 다른 플레이스홀더처럼 입력을 받습니다. 스크립트가 직접 바인딩한 변수는 그대로 둡니다: 그 안의 무엇이든DECLARE목록(테이블 변수 포함), 다음의 대상SET @x,SELECT @x =또는FETCH … INTO @x, 다음 안의 매개변수 이름EXEC dbo.Proc @Id = …,@@ROWCOUNT-스타일 함수와, 프로시저·함수·트리거를 만드는 스크립트에 나오는 모든 이름(Procedure 모드가 알아서 채웁니다). MySQL에서@name사용자 변수이며 값을 묻지 않습니다.




값이 전송되는 방식
값은 데이터베이스가 이해할 수 있는 리터럴로 변환되고 이스케이프 처리되므로, 값 안의 따옴표, 백슬래시 또는 ' OR '1'='1 값 안에 있으면 언제나 그냥 데이터입니다. 입력하는 내용이 값의 종류를 정합니다:
- 숫자
42,-3.5그리고1e6숫자로 입력됩니다. 우편번호처럼 선행 0이 있는 숫자는007텍스트로 유지됩니다.true/false- 부울은 사용 중인 엔진이 표기하는 그대로 씁니다(
1/0SQL Server와 MySQL에서는 해당 방식입니다). NULL- SQL NULL. 빈 입력은 절대 NULL이 아니라 누락된 값으로 취급되며, 실행 시 값을 묻습니다.
- 그 밖의 모든 것
- 텍스트, 엔진에 맞게 따옴표 처리:
active다음과 같이 됩니다'active'. 'quoted'- 값을 텍스트로 강제하려면 작은따옴표로 감싸세요:
'42'문자열 42를 전송하고''빈 문자열을 전송합니다.
int_col = :id 그리고 text_col = :id 둘 다 동일한 입력에 대해 작동합니다.실행하는 문장만 값이 필요합니다
스트립에는 스크립트의 모든 자리 표시자가 나열되므로 미리 값을 채워 둘 수 있습니다. 실행할 때는 실제로 실행되는 부분(선택 영역 또는 현재 명령문)의 자리 표시자만 값을 필요로 합니다. 하나라도 비어 있으면 아무것도 전송되지 않고, 상태 표시줄이 그 이름을 알려 주며 해당 행에는 필수, 커서가 그 안으로 이동합니다.


설명 그리고 쿼리 실행 계획 명령도 같은 값을 쓰므로, 계획이 실제로 실행할 그 쿼리에 대해 나옵니다.
플레이스홀더에 유형과 기본값을 지정하세요
A -- sqlly param: 줄은 자리표시자에 타입을 지정합니다. 실행 전에 입력이 검사되고, 비워 두면 기본값으로 돌아갑니다.
-- sqlly param: :since date = 2026-01-01
-- sqlly param: :limit int = 50
SELECT * FROM orders WHERE created_at >= :since LIMIT :limit;
유형은 text, int, decimal, bool,
date, datetime, time, uuid, json
그리고 binary. 같은 줄에 다음이 붙으면 @name SQLly가 다음을 대신 끼워 넣는 매개변수를 선언합니다 @name 그 자체입니다. 자세한 내용은 SQLly 지시문.
절대 자리 표시자가 아닌 것
SQLly는 데이터베이스처럼 SQL을 읽으므로, 매개변수가 아닌 값을 요구하지 않습니다: 문자열, 주석, 따옴표로 묶은 이름 또는 PostgreSQL
$$ 함수 본문; :: 캐스트; 배열 슬라이스와 같은
arr[lo:hi]; 다음과 같은 JSON 경로 metadata:country; MySQL의
:= 그리고 루프 레이블까지 알아봅니다. SQL Server sqlcmd 줄, 가령 :setvar; 그리고 Oracle의 :new / :old 트리거에서도 마찬가지입니다.
값이 탭에 남아 있습니다
입력한 값은 탭과 함께 저장되고, 다른 창으로 옮겨도 그대로 유지되며, SQLly를 다시 시작하면 돌아옵니다. 이름이 지정된 자리 표시자는 최근 사용한 값이 입력란 옆에 원클릭 칩으로 나타나고, 포매터는 자리 표시자를 입력한 그대로 둡니다.
-- sqlly param: 줄은 계속 작동합니다.