RelationalDatabaseFacadeExtensions.ExecuteSqlRaw 메서드

정의

네임스페이스:

Microsoft.EntityFrameworkCore

어셈블리:

Microsoft.EntityFrameworkCore.Relational.dll

패키지:

Microsoft.EntityFrameworkCore.Relational v8.0.0

오버로드

ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>)	데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다.
ExecuteSqlRaw(DatabaseFacade, String, Object[])	데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다.

ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>)

데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다.

public static int ExecuteSqlRaw (this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, System.Collections.Generic.IEnumerable<object> parameters);

static member ExecuteSqlRaw : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * seq<obj> -> int

<Extension()>
Public Function ExecuteSqlRaw (databaseFacade As DatabaseFacade, sql As String, parameters As IEnumerable(Of Object)) As Integer

매개 변수

databaseFacade

DatabaseFacade

DatabaseFacade 컨텍스트에 대한 입니다.

sql

String

실행할 SQL입니다.

parameters

IEnumerable<Object>

SQL과 함께 사용할 매개 변수입니다.

반환

Int32

영향을 받은 행 수입니다.

설명

이 메서드는 트랜잭션을 시작하지 않습니다. 트랜잭션에서 이 메서드를 사용하려면 먼저 또는 를 호출 BeginTransaction(DatabaseFacade, IsolationLevel) 합니다 UseTransaction.

SQL이 idempotent가 아니고 트랜잭션에서 실행되지 않으므로 현재 ExecutionStrategy 는 이 메서드에서 사용되지 않습니다. 를 ExecutionStrategy 명시적으로 사용할 수 있으며 SQL이 idempotent가 아닌 경우에도 트랜잭션을 사용해야 합니다.

SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter로 변환됩니다.

그러나 유효성이 검사되지 않은 사용자 제공 값이 있는 연결되거나 보간된 문자열($"")을 이 메서드에 전달하지 않습니다. 이렇게 하면 애플리케이션이 SQL 삽입 공격에 노출 될 수 있습니다. 보간된 문자열 구문을 사용하려면 를 사용하여 ExecuteSql(DatabaseFacade, FormattableString) 매개 변수를 만드는 것이 좋습니다.

자세한 내용 과 예제는 EF Core를 사용하여 원시 SQL 명령 실행을 참조하세요.

ExecuteSqlRaw(DatabaseFacade, String, Object[])

데이터베이스에 대해 지정된 SQL을 실행하고 영향을 받는 행 수를 반환합니다.

public static int ExecuteSqlRaw (this Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade databaseFacade, string sql, params object[] parameters);

static member ExecuteSqlRaw : Microsoft.EntityFrameworkCore.Infrastructure.DatabaseFacade * string * obj[] -> int

<Extension()>
Public Function ExecuteSqlRaw (databaseFacade As DatabaseFacade, sql As String, ParamArray parameters As Object()) As Integer

매개 변수

databaseFacade

DatabaseFacade

DatabaseFacade 컨텍스트에 대한 입니다.

sql

String

실행할 SQL입니다.

parameters

Object[]

SQL과 함께 사용할 매개 변수입니다.

반환

Int32

영향을 받은 행 수입니다.

설명

이 메서드는 트랜잭션을 시작하지 않습니다. 트랜잭션에서 이 메서드를 사용하려면 먼저 또는 를 호출 BeginTransaction(DatabaseFacade, IsolationLevel) 합니다 UseTransaction.

SQL이 idempotent가 아니고 트랜잭션에서 실행되지 않으므로 현재 ExecutionStrategy 는 이 메서드에서 사용되지 않습니다. 를 ExecutionStrategy 명시적으로 사용할 수 있으며 SQL이 idempotent가 아닌 경우에도 트랜잭션을 사용해야 합니다.

SQL을 허용하는 모든 API와 마찬가지로 SQL 삽입 공격으로부터 보호하기 위해 사용자 입력을 매개 변수화하는 것이 중요합니다. SQL 쿼리 문자열에 매개 변수 자리 표시자를 포함하고 매개 변수 값을 추가 인수로 제공할 수 있습니다. 사용자가 제공하는 모든 매개 변수 값은 자동으로 DbParameter로 변환됩니다.

그러나 유효성이 검사되지 않은 사용자 제공 값이 있는 연결되거나 보간된 문자열($"")을 이 메서드에 전달하지 않습니다. 이렇게 하면 애플리케이션이 SQL 삽입 공격에 노출 될 수 있습니다. 보간된 문자열 구문을 사용하려면 를 사용하여 ExecuteSql(DatabaseFacade, FormattableString) 매개 변수를 만드는 것이 좋습니다.

자세한 내용 과 예제는 EF Core를 사용하여 원시 SQL 명령 실행을 참조하세요.