SQL 기계 학습에서 PREDICT T-SQL 함수를 사용하는 네이티브 채점

아티클
07/12/2024

적용 대상: SQL Server 2017(14.x) 이상 Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics

PREDICT T-SQL 함수와 함께 네이티브 채점을 사용하여 거의 실시간으로 새 데이터 입력에 대한 예측 값을 생성하는 방법을 알아봅니다. 네이티브 채점에는 이미 학습된 모델이 있어야 합니다.

PREDICT 함수는 SQL 기계 학습에서 네이티브 C++ 확장 기능을 사용합니다. 이 방법론은 ONNX(Open Neural Network Exchange) 형식의 예측 및 예측 워크로드와 지원 모델 또는 RevoScaleR 및 revoscalepy 패키지를 사용하여 훈련된 모델의 가장 빠른 처리 속도를 제공합니다.

네이티브 채점 작동 방식

네이티브 채점은 ONNX 또는 미리 정의된 이진 형식으로 모델을 읽고 사용자가 제공하는 새 데이터 입력에 대한 점수를 생성할 수 있는 라이브러리를 사용합니다. 모델은 학습, 배포 및 저장되므로 R 또는 Python 인터프리터를 호출하지 않고도 채점에 사용할 수 있습니다. 즉, 다중 프로세스 상호 작용의 오버헤드가 감소하여 예측 속도가 향상됩니다.

네이티브 채점을 사용하려면 PREDICT T-SQL 함수를 호출하고 다음과 같은 필수 입력을 전달합니다.

지원되는 모델 및 알고리즘을 기반으로 하는 호환 모델.
일반적으로 T-SQL 쿼리로 정의되는 입력 데이터입니다.

이 함수는 전달하려는 원본 데이터의 모든 열과 함께 입력 데이터에 대한 예측을 반환합니다.

필수 조건

PREDICT는 다음 시스템에서 사용할 수 있습니다.

Windows 및 Linux의 모든 SQL Server 2017 이상 버전
Azure SQL Managed Instance
Azure SQL Database
Azure SQL Edge
Azure Synapse Analytics

이 함수는 기본적으로 사용됩니다. R 또는 Python을 설치하거나 추가 기능을 사용하도록 설정할 필요는 없습니다.

지원되는 모델

PREDICT 함수에서 지원하는 모델 형식은 네이티브 채점을 수행하는 SQL 플랫폼에 따라 달라집니다. 어떤 플랫폼에서 어떤 모델 형식이 지원되는지 확인하려면 아래 표를 참조하세요.

플랫폼	ONNX 모델 형식	RevoScale 모델 형식
SQL Server	예	예
Azure SQL Managed Instance	예	예
Azure SQL Database	예	예
Azure SQL Edge	예	아니요
Azure Synapse Analytics	예	아니요

ONNX 모델

이 모델은 ONNX(Open Neural Network Exchange) 모델 형식이어야 합니다.

RevoScale 모델

RevoScaleR 또는 revoscalepy 패키지를 사용하여 아래에 나열된 지원되는 rx 알고리즘 중 하나로 모델을 미리 학습해야 합니다.

R에는 rxSerialize를 사용하고 Python에는 rx_serialize_model을 사용하여 모델을 직렬화합니다. 이러한 직렬화 함수는 빠른 채점을 지원하도록 최적화되었습니다.

지원되는 RevoScale 알고리즘

revoscalepy 및 RevoScaleR에서 지원되는 알고리즘은 다음과 같습니다.

revoscalepy 알고리즘
- rx_lin_mod
- rx_logit
- rx_btrees
- rx_dtree
- rx_dforest
revoscalepy 알고리즘
- rxLinMod
- rxLogit
- rxBTrees
- rxDtree
- rxDForest

MicrosoftML 또는 microsoftml의 알고리즘을 사용해야 하는 경우 sp_rxPredict를 사용한 실시간 채점을 사용합니다.

지원되지 않는 모델 형식에는 다음 형식이 포함됩니다.

다른 변환이 포함된 모델
RevoScaleR 또는 revoscalepy 등가물에서 rxGlm 또는 rxNaiveBayes 알고리즘을 사용하는 모델
PMML models
다른 오픈 소스 또는 타사 라이브러리를 사용하여 만든 모델

예제

ONNX 모델을 사용하는 PREDICT

이 예제에서는 네이티브 채점을 위해 dbo.models 테이블에 저장된 ONNX 모델을 사용하는 방법을 보여줍니다.

DECLARE @model VARBINARY(max) = (
        SELECT DATA
        FROM dbo.models
        WHERE id = 1
        );

WITH predict_input
AS (
    SELECT TOP (1000) [id]
        , CRIM
        , ZN
        , INDUS
        , CHAS
        , NOX
        , RM
        , AGE
        , DIS
        , RAD
        , TAX
        , PTRATIO
        , B
        , LSTAT
    FROM [dbo].[features]
    )
SELECT predict_input.id
    , p.variable1 AS MEDV
FROM PREDICT(MODEL = @model, DATA = predict_input, RUNTIME=ONNX) WITH (variable1 FLOAT) AS p;

참고 항목

PREDICT에서 반환되는 열과 값은 모델 형식에 따라 다를 수 있으므로 WITH 절을 사용하여 반환된 데이터의 스키마를 정의해야 합니다.

RevoScale 모델을 사용하는 PREDICT

이 예제에서는 R에서 RevoScaleR을 사용하여 모델을 만든 다음 T-SQL에서 실시간 예측 함수를 호출합니다.

1단계. 모델 준비 및 저장

다음 코드를 실행하여 샘플 데이터베이스 및 필수 테이블을 만듭니다.

CREATE DATABASE NativeScoringTest;
GO
USE NativeScoringTest;
GO
DROP TABLE IF EXISTS iris_rx_data;
GO
CREATE TABLE iris_rx_data (
    "Sepal.Length" float not null, "Sepal.Width" float not null
  , "Petal.Length" float not null, "Petal.Width" float not null
  , "Species" varchar(100) null
);
GO

다음 문을 사용하여 데이터 테이블을 아이리스 데이터 세트의 데이터로 채웁니다.

INSERT INTO iris_rx_data ("Sepal.Length", "Sepal.Width", "Petal.Length", "Petal.Width" , "Species")
EXECUTE sp_execute_external_script
  @language = N'R'
  , @script = N'iris_data <- iris;'
  , @input_data_1 = N''
  , @output_data_1_name = N'iris_data';
GO

이제 모델을 저장하기 위한 테이블을 만듭니다.

DROP TABLE IF EXISTS ml_models;
GO
CREATE TABLE ml_models ( model_name nvarchar(100) not null primary key
  , model_version nvarchar(100) not null
  , native_model_object varbinary(max) not null);
GO

다음 코드는 아이리스 데이터 세트를 기반으로 하는 모델을 만들고 이를 models라는 테이블에 저장합니다.

DECLARE @model varbinary(max);
EXECUTE sp_execute_external_script
  @language = N'R'
  , @script = N'
    iris.sub <- c(sample(1:50, 25), sample(51:100, 25), sample(101:150, 25))
    iris.dtree <- rxDTree(Species ~ Sepal.Length + Sepal.Width + Petal.Length + Petal.Width, data = iris[iris.sub, ])
    model <- rxSerializeModel(iris.dtree, realtimeScoringOnly = TRUE)
    '
  , @params = N'@model varbinary(max) OUTPUT'
  , @model = @model OUTPUT
  INSERT [dbo].[ml_models]([model_name], [model_version], [native_model_object])
  VALUES('iris.dtree','v1', @model) ;

참고 항목

RevoScaleR의 rxSerializeModel 함수를 사용하여 모델을 저장해야 합니다. 표준 R serialize 함수는 필요한 형식을 생성할 수 없습니다.

다음과 같은 문을 실행하여 저장된 모델을 이진 형식으로 볼 수 있습니다.

SELECT *, datalength(native_model_object)/1024. as model_size_kb
FROM ml_models;

2단계. 모델에서 PREDICT 실행

다음은 네이티브 채점 함수를 사용하여 의사 결정 트리 모델에서 분류를 가져오는 간단한 PREDICT 문입니다. 제공하는 특성, 꽃잎 길이 및 너비에 따라 아이리스 종을 예측합니다.

DECLARE @model varbinary(max) = (
  SELECT native_model_object
  FROM ml_models
  WHERE model_name = 'iris.dtree'
  AND model_version = 'v1');
SELECT d.*, p.*
  FROM PREDICT(MODEL = @model, DATA = dbo.iris_rx_data as d)
  WITH(setosa_Pred float, versicolor_Pred float, virginica_Pred float) as p;
go

"PREDICT 함수를 실행하는 동안 오류가 발생했습니다. 모델이 손상되었거나 잘못되었습니다." 오류가 발생하는 경우 이는 일반적으로 쿼리가 모델을 반환하지 않았음을 의미합니다. 모델 이름을 올바르게 입력했는지 또는 모델 테이블이 비어 있는지 확인합니다.

참고 항목

PREDICT에서 반환되는 열과 값은 모델 형식에 따라 다를 수 있으므로 WITH 절을 사용하여 반환된 데이터의 스키마를 정의해야 합니다.

다음을 통해 공유

SQL 기계 학습에서 PREDICT T-SQL 함수를 사용하는 네이티브 채점

네이티브 채점 작동 방식

필수 조건

지원되는 모델

ONNX 모델

RevoScale 모델

지원되는 RevoScale 알고리즘

예제

ONNX 모델을 사용하는 PREDICT

RevoScale 모델을 사용하는 PREDICT

1단계. 모델 준비 및 저장

2단계. 모델에서 PREDICT 실행

다음 단계

피드백

추가 리소스