매개 변수 쿼리(Visual Database Tools)Parameter Queries (Visual Database Tools)

이 항목 적용 대상: 예SQL Server예Azure SQL 데이터베이스예Azure SQL 데이터 웨어하우스 예 병렬 데이터 웨어하우스THIS TOPIC APPLIES TO: yesSQL ServeryesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse 경우에 따라 매번 다른 값으로 여러 번 사용할 수 있는 쿼리를 만들 필요가 있습니다. In some cases you want to create a query that you can use many times, but with a different value each time. 예를 들어, 한 명의 저자가 저술한 책의 title_ids 를 모두 찾기 위해 쿼리하는 경우가 종종 있습니다.For example, you might frequently run a query to find all the title_ids written by one author. 각 요청에 대해 매번 저자의 ID 또는 이름만 다른 동일한 쿼리를 실행할 수 있습니다.You could run the same query for each request, except that the author's ID or name would be different each time.

매번 다른 값을 가질 수 있는 쿼리를 만들려면 쿼리에 매개 변수를 사용합니다.To create a query that can have different values at different times, you use parameters in the query. 매개 변수는 쿼리를 실행할 때 제공되는 값에 대한 자리 표시자입니다.A parameter is a placeholder for a value that is supplied when the query runs. 매개 변수를 사용하는 SQL 문은 다음과 같습니다. 여기에서 "?"는 저자의 ID에 대한 매개 변수입니다.An SQL statement with a parameter might look like the following, where "?" represents the parameter for the author's ID:

SELECT title_id  
FROM titleauthor  
WHERE (au_id = ?)  

매개 변수를 사용할 수 있는 위치Where You Can Use Parameters

매개 변수를 리터럴 텍스트 값 또는 리터럴 숫자 값에 대한 자리 표시자로 사용할 수 있습니다.You can use parameters as placeholders for literal values — for either text or numeric values. 매개 변수는 일반적으로 SQL 문의 WHERE 절 또는 HAVING 절에 있는 개별 행이나 그룹에 대한 검색 조건에서 자리 표시자로 사용됩니다.Most commonly, parameters are used as placeholders in search conditions for individual rows or for groups (that is, in the WHERE or HAVING clauses of an SQL statement).

매개 변수를 식의 자리 표시자로 사용할 수 있습니다.You can use parameters as placeholders in expressions. 예를 들어, 쿼리를 실행할 때마다 다른 할인 가격을 제공하여 할인된 가격을 계산할 수 있습니다.For example, you might want to calculate discounted prices by supplying a different discount value each time you run a query. 이렇게 하려면 다음과 같은 식을 지정합니다.To do so, you could specify the following expression:

(price * ?)  

명명되지 않은 매개 변수 및 명명된 매개 변수 지정Specifying Unnamed and Named Parameters

명명되지 않은 매개 변수와 명명된 매개 변수와 같이 두 가지 형식의 매개 변수를 지정할 수 있습니다.You can specify two types of parameters: unnamed and named. 명명되지 않은 매개 변수는 리터럴 값을 입력하거나 이를 대체할 쿼리의 임의 위치에 넣는 물음표(?)입니다.An unnamed parameter is a question mark (?) that you put anywhere in the query that you want to prompt for or substitute a literal value. 예를 들어 titleauthor 테이블에서 저자의 ID를 검색하기 위해 명명되지 않은 매개 변수를 사용하는 경우 SQL 창 에 나타나는 결과 문은 다음과 같습니다.For example, if you use an unnamed parameter to search for an author's id in the titleauthor table, the resulting statement in the SQL Pane might look like this:

SELECT title_id  
FROM titleauthor  
WHERE (au_id = ?)  

쿼리 및 뷰 디자이너에서 쿼리를 실행하면 쿼리 매개 변수 대화 상자 에 매개 변수 이름으로 "?"가 나타납니다.When you run the query in the Query and View Designer, the Query Parameters Dialog Box appears with "?" as the name of the parameter.

또는 매개 변수에 이름을 할당할 수도 있습니다.Alternatively, you can assign a name to a parameter. 명명된 매개 변수는 쿼리에 여러 개의 매개 변수가 있는 경우 특히 유용합니다.Named parameters are particularly useful if you have multiple parameters in a query. 예를 들어, 명명된 매개 변수를 사용하여 authors 테이블에서 저자의 이름과 성을 검색하는 경우 SQL 창에 나타나는 결과 문은 다음과 같습니다.For example, if you use named parameters to search for an author's first and last names in the authors table, the resulting statement in the SQL pane might look like this:

SELECT au_id  
FROM authors  
WHERE au_fname = %first name% AND  
      au_lname = %last name%  

명명된 매개 변수 쿼리를 만들기 전에 접두사와 접미사를 정의해야 합니다.You must define prefix and suffix characters before creating a named parameter query.

쿼리 및 뷰 디자이너에서 쿼리를 실행하면 쿼리 매개 변수 대화 상자 에 명명된 매개 변수의 목록이 나타납니다.When you run the query in the Query and View Designer, the Query Parameters Dialog Box appears with a list of named parameters.

관련 항목:See Also

매개 변수를 사용하여 쿼리(Visual Database Tools)Query with Parameters (Visual Database Tools)
지원되는 쿼리 형식(Visual Database Tools)Supported Query Types (Visual Database Tools)
쿼리 및 뷰 디자인 방법 도움말 항목(Visual Database Tools)Design Queries and Views How-to Topics (Visual Database Tools)