테이블 반환 매개 변수(TVP)

-- (1) 넘길 표의 모양을 형식으로 만듭니다.
CREATE TYPE Board.CommentList AS TABLE (
    post_num int            NOT NULL,
    user_num int            NOT NULL,
    content  nvarchar(1000) NOT NULL,
    PRIMARY KEY (post_num, user_num)      -- 키도 달 수 있습니다
);
GO
-- (2) 그 형식을 매개 변수로 받습니다. READONLY 를 반드시 붙입니다.
CREATE OR ALTER PROCEDURE Board.P_COMMENT_ADD_MANY
    @items Board.CommentList READONLY
AS
BEGIN
    SET NOCOUNT ON;

    INSERT INTO Board.COMMENTS (post_num, user_num, content, reg_date)
    SELECT post_num, user_num, content, '2026-03-01' FROM @items;

    SELECT @@ROWCOUNT AS 넣은행;
END
GO
-- (3) 변수에 담아 넘깁니다.
DECLARE @t Board.CommentList;
INSERT INTO @t (post_num, user_num, content)
SELECT TOP (5) 1, num, N'댓글 ' + CAST(num AS nvarchar(10)) FROM Member.USERS ORDER BY num;

EXEC Board.P_COMMENT_ADD_MANY @items = @t;

-- 견주는 데 쓸 표·형식·프로시저를 먼저 만듭니다.
CREATE TABLE Board.T_TVP (
    num  int IDENTITY PRIMARY KEY,
    code varchar(10) NOT NULL,
    val  int NOT NULL
);
GO
CREATE TYPE Board.ItemList AS TABLE (
    code varchar(10) NOT NULL PRIMARY KEY,   -- 키를 달아 둡니다
    val  int NOT NULL
);
GO
CREATE OR ALTER PROCEDURE Board.P_ITEM_ADD_ONE @code varchar(10), @val int
AS BEGIN SET NOCOUNT ON;
    INSERT INTO Board.T_TVP (code, val) VALUES (@code, @val); END
GO
CREATE OR ALTER PROCEDURE Board.P_ITEM_ADD_MANY @items Board.ItemList READONLY
AS BEGIN SET NOCOUNT ON;
    INSERT INTO Board.T_TVP (code, val) SELECT code, val FROM @items; END
GO

-- (가) 한 건씩 1,000번 부릅니다.
DECLARE @i int = 1;
WHILE @i <= 1000
BEGIN EXEC Board.P_ITEM_ADD_ONE @code = 'C', @val = @i; SET @i += 1; END

-- (나) TVP 로 한 번 부릅니다.
DECLARE @t Board.ItemList;
INSERT INTO @t (code, val)
SELECT TOP (1000)
    'C' + CAST(ROW_NUMBER() OVER (ORDER BY (SELECT NULL)) AS varchar(6)),
    ROW_NUMBER() OVER (ORDER BY (SELECT NULL))
FROM Board.POSTS;
EXEC Board.P_ITEM_ADD_MANY @items = @t;
GO
-- 프로시저가 몇 번 실행되었는지 봅니다.
SELECT OBJECT_NAME(ps.object_id) AS 프로시저, ps.execution_count AS 실행횟수,
       ps.total_logical_reads AS 논리적읽기, ps.total_worker_time / 1000 AS CPU밀리초
FROM sys.dm_exec_procedure_stats ps
WHERE ps.database_id = DB_ID();

-- (가) READONLY 를 빼면
CREATE OR ALTER PROCEDURE Board.P_BAD (@items Board.CommentList)
AS BEGIN SELECT COUNT(*) FROM @items; END
GO

-- (나) 넘어온 자료를 고치려 하면
CREATE OR ALTER PROCEDURE Board.P_BAD2 (@items Board.CommentList READONLY)
AS BEGIN UPDATE @items SET content = N'x'; END

-- 열을 하나 더하고 싶습니다.
ALTER TYPE Board.ItemList ADD note nvarchar(50);   -- 그런 문법이 없습니다

-- 그러면 지우고 다시 만들어야 하는데
DROP TYPE Board.ItemList;

DECLARE @t Board.ItemList;               -- code 가 기본 키입니다
INSERT INTO @t (code, val) VALUES ('C1', 10);
INSERT INTO @t (code, val) VALUES ('C1', 20);

DECLARE @csv nvarchar(max) = N'10,20,30,40,50';
SELECT value AS 값, CAST(value AS int) * 2 AS 두배 FROM STRING_SPLIT(@csv, N',');

-- 순서가 필요하면 세 번째 인수를 1 로 줍니다.
SELECT value, ordinal FROM STRING_SPLIT(N'10,20,30', N',', 1);

-- 쉼표 안에 콜론을 또 넣어야 합니다.
DECLARE @csv nvarchar(max) = N'C1:10,C2:20';
SELECT LEFT(value, CHARINDEX(':', value) - 1) AS code,
       SUBSTRING(value, CHARINDEX(':', value) + 1, 100) AS val
FROM STRING_SPLIT(@csv, N',');

-- JSON 이면 모양이 그대로 드러납니다.
DECLARE @json nvarchar(max) = N'[{"code":"C1","val":10},{"code":"C2","val":20}]';
SELECT code, val FROM OPENJSON(@json)
     WITH (code varchar(20) '$.code', val int '$.val');

var table = new DataTable();
table.Columns.Add("post_num", typeof(int));
table.Columns.Add("user_num", typeof(int));
table.Columns.Add("content", typeof(string));

foreach (var c in comments)
    table.Rows.Add(c.PostNum, c.UserNum, c.Content);

var p = cmd.Parameters.AddWithValue("@items", table);
p.SqlDbType = SqlDbType.Structured;
p.TypeName  = "Board.CommentList";      // 형식 이름을 알려 줍니다