SQL Server

Microsoft SQL Server는 Microsoft에서 개발한 관계형 데이터베이스 관리 시스템입니다. SQL Server에 연결하여 데이터를 관리합니다. 테이블의 행에서 만들기, 업데이트, 가져오기 및 삭제와 같은 다양한 작업을 수행할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	Regions
Copilot Studio	Premium	모든 Power Automate 지역
논리 앱	스탠다드	모든 Logic Apps 지역
Power Apps	Premium	모든 Power Apps 지역
Power Automate	Premium	모든 Power Automate 지역

커넥터 메타데이터
게시자	Microsoft

커넥터 심층 분석

이 문서에서는 Azure Logic Apps, Power Automate 및 Power Apps에 사용할 수 있는 SQL Server 관리 커넥터에 대한 작업을 설명합니다. SQL Server 기본 제공 커넥터는 Azure Logic Apps의 표준 논리 앱 워크플로에만 사용할 수 있습니다.

• Power Apps의 이 커넥터에 대한 자세한 내용은 Power Apps에서 SQL Server에 연결을 참조하세요.
• Azure Logic Apps의 SQL Server 기본 제공 커넥터 및 관리 커넥터에 대한 자세한 내용은 Azure Logic Apps의 워크플로에서 SQL 데이터베이스에 연결을 참조하세요.

Authentication

비 Microsoft Entra ID(Microsoft Entra ID) 연결을 만들려면 연결 문자열 인증 옵션을 사용합니다. 연결에 정의된 것과 동일한 서버 이름 및 데이터베이스 이름 값을 제공해야 합니다.

Microsoft Entra ID 인증

Microsoft Entra ID 인증의 알려진 제한 사항

현재 인증 파이프라인 제한으로 인해 Microsoft Entra ID 게스트 사용자는 SQL Server에 대한 Microsoft Entra ID 연결에 대해 지원되지 않습니다. 이 문제를 해결하려면 SQL Server 인증 또는 Windows 인증을 대신 사용합니다.

SQL Server에 대해 Microsoft Entra ID 인증 사용

1. 계정을 SQL Microsoft Entra ID(Microsoft Entra ID) 멤버로 설정하고 프로비전합니다. 자세한 내용은 Azure SQL을 사용하여 Microsoft Entra ID 인증 구성 및 관리를 참조하세요.

2. SQL Server에서 Microsoft Entra ID 관리자를 설정합니다.

   1. Azure Portal에서 Microsoft Entra ID 인증을 사용하도록 설정하려는 SQL Server로 이동합니다.
   2. SQL Server 리소스 메뉴의 설정에서 Microsoft Entra ID를 선택합니다.
   3. Microsoft Entra ID 창 도구 모음에서 관리자 설정을 선택합니다.
   4. 현재 테넌트에서 Microsoft Entra ID 사용자 계정을 찾아서 선택하여 서버 관리자로 만듭니다. 변경 내용을 저장합니다.

3. Microsoft Entra ID 테넌트에서 SQL 데이터베이스에 액세스하기 위한 Microsoft Entra ID 애플리케이션을 만들고 등록합니다. 자세한 내용은 SQL Server - Microsoft Entra ID 인증 설정을 참조하세요.

   1. Azure Portal에서 Microsoft Entra ID 애플리케이션을 만들려는 Microsoft Entra ID 테넌트로 이동합니다.

   2. 테넌트 메뉴의 관리 아래에서 앱 등록 새 등록을> 선택합니다.

   3. 애플리케이션 등록 창에서 애플리케이션의 이름을 입력합니다. 나중에 사용자를 만들고 SQL 데이터베이스에 대한 역할 액세스 권한을 부여할 수 있도록 이 이름을 기억하세요.

   4. 완료되면 등록을 선택하여 Microsoft Entra ID 애플리케이션을 만듭니다.

   5. 앱 등록 창에서 새 Microsoft Entra ID 애플리케이션을 선택합니다. 애플리케이션 메뉴에서 인증서 및 비밀>새 클라이언트 비밀을 선택합니다.

   6. 비밀에 대한 설명을 제공하고 만료를 선택합니다.

4. 서버 관리자로 설정한 Microsoft Entra ID 사용자 계정에 대한 자격 증명을 사용하여 SQL Server 및 데이터베이스에 로그인합니다.

5. SQL 데이터베이스에서 포함된 사용자를 만들어 Microsoft Entra ID 애플리케이션을 나타냅니다. 이 단계를 수행하려면 Microsoft SSMS(SQL Server Management Studio)가 필요합니다.

   다음 단계에서는 이름을 example-Azure-AD-application-name사용하여 Microsoft Entra ID 애플리케이션의 db_datareader 역할을 할당합니다db_datawriter. 지정된 명령을 실행할 때는 Microsoft Entra ID 애플리케이션의 이름으로 바꾸고 example-Azure-AD-application-name 요구 사항에 필요한 역할을 할당해야 합니다.

   1. SSMS를 시작하고 Microsoft Entra ID 애플리케이션이 액세스할 SQL Server에 연결합니다.

   2. 인증에서 서버 관리자로 설정한 MFA 지원 및 Microsoft Entra ID 계정을 사용하여 Active Directory - Universal을 사용합니다.

   3. 개체 탐색기에서 데이터베이스 폴더를 확장합니다.

   4. 데이터베이스를 찾고, 데이터베이스 바로 가기 메뉴를 열고, 새 쿼리를 선택합니다.

   5. 쿼리 창에서 다음 명령을 실행하여 Microsoft Entra ID 애플리케이션을 데이터베이스의 새 사용자에 연결합니다.

      CREATE USER [example-Azure-AD-app-name] FROM EXTERNAL PROVIDER
      

   6. 쿼리 창을 지웁 수 있습니다. 그런 다음, 다음 명령을 실행하여 Microsoft Entra ID 애플리케이션에 역할을 할당 db_datareader 합니다.

      ALTER ROLE db_datareader ADD MEMBER [example-Azure-AD-application-name]
      

   7. 이전 단계를 반복하여 Microsoft Entra ID 애플리케이션에 역할을 할당 db_datawriter 합니다.

      ALTER ROLE db_datawriter ADD MEMBER [example-Azure-AD-application-name]
      

관리 ID 인증

현재 Azure Logic Apps만 SQL Server 커넥터에 대한 관리 ID 인증 을 지원합니다.

서비스 주체 인증

논리 앱에서 관리 ID 설정

1. Azure Portal에서 논리 앱 리소스로 이동합니다.

2. 시스템 할당 ID 또는 사용자 할당 ID를 사용하도록 설정합니다. 사용자 할당 ID가 없는 경우 먼저 해당 ID를 만들어야 합니다. 자세한 내용은 Azure Logic Apps에서 관리 ID를 사용하여 Azure 리소스에 대한 액세스 인증을 참조하세요.

3. 사용자 할당 ID를 선택한 경우 논리 앱 리소스에 해당 ID를 추가했는지 확인합니다.

   1. Azure Portal에서 관리 ID를 사용하려는 논리 앱 리소스로 이동합니다.
   2. 논리 앱 탐색 메뉴의 설정 아래에서 ID를 선택합니다.
   3. 사용자 할당 탭에서 추가를 클릭합니다.
   4. 사용할 관리 ID를 선택하고 추가를 선택합니다.

관리 ID 인증을 위한 SQL Server 설정

1. SQL Server에서 Microsoft Entra ID 관리자를 설정합니다.

   1. Azure Portal에서 Microsoft Entra ID 인증을 사용하도록 설정하려는 SQL Server로 이동합니다.
   2. SQL Server 리소스 메뉴의 설정에서 Microsoft Entra ID를 선택합니다.
   3. Microsoft Entra ID 창 도구 모음에서 관리자 설정을 선택합니다.
   4. 현재 테넌트에서 Microsoft Entra ID 사용자 계정을 찾아서 선택하여 서버 관리자로 만듭니다. 변경 내용을 저장합니다.

2. SQL 데이터베이스에서 관리 ID를 나타내는 포함된 사용자를 만듭니다. 이 단계를 수행하려면 Microsoft SSMS(SQL Server Management Studio)가 필요합니다.

   다음 단계에서는 이름을 example-managed-identity-name사용하여 관리 ID에 역할을 db_datareader 할당합니다. 지정된 명령을 실행할 때는 관리 ID의 이름으로 바꾸고 example-managed-identity-name 요구 사항에 맞는 올바른 역할을 할당해야 합니다. 예를 들어 db_datareader 쓰기 작업을 실행할 수 없습니다.

   1. SSMS를 시작하고 관리 ID가 액세스할 SQL Server에 연결합니다.

   2. 인증에서 서버 관리자로 설정한 MFA 지원 및 Microsoft Entra ID 계정을 사용하여 Active Directory - Universal을 사용합니다.

   3. 개체 탐색기에서 데이터베이스 폴더를 확장합니다.

   4. 데이터베이스를 찾고, 데이터베이스 바로 가기 메뉴를 열고, 새 쿼리를 선택합니다.

   5. 쿼리 창에서 다음 명령을 실행하여 관리 ID를 데이터베이스의 새 사용자에 연결합니다.

      CREATE USER [example-managed-identity-name] FROM EXTERNAL PROVIDER
      

   6. 쿼리 창을 지웁 수 있습니다. 그런 다음, 다음 명령을 실행하여 관리 ID에 역할을 할당합니다.

      ALTER ROLE db_datareader ADD MEMBER [example-managed-identity-name]
      

      비고

      데이터베이스 수준에서 관리 ID에 역할을 할당하는 경우 ID에 모든 데이터베이스를 나열하는 데 필요한 범위가 없습니다. SQL 트리거 또는 작업의 데이터베이스 이름 목록에서 선택하면 다음 예제와 같은 오류가 발생합니다.

      Couldn't retrieve values. Error code: 'Unauthorized', Message: 'Credentials are missing or not valid'.
      Inner exception: The credentials provided for the SQL source are invalid
      

      이 문제를 해결하려면 다음 옵션이 있습니다.

      • 관리 ID에 모든 데이터베이스를 나열할 수 있는 서버 수준 역할을 할당합니다.
      • SQL 트리거 또는 작업에서 사용자 지정 값 입력 옵션을 사용하여 데이터베이스 이름을 입력합니다.

자세한 내용은 다음 설명서를 검토하세요.

• Azure Logic Apps에서 관리 ID를 사용하여 Azure 리소스에 대한 액세스 인증
• 자습서: Windows VM 시스템 할당 관리 ID를 사용하여 Azure SQL에 액세스
• Azure SQL을 사용하여 Microsoft Entra ID 인증 구성 및 관리
• 데이터베이스 수준 역할
• 서버 수준 역할

Virtual Network 지원

Virtual Network에 연결된 Power Platform 환경에서 커넥터를 사용하는 경우 다음과 같은 제한 사항이 적용됩니다.

• 다음 작업은 유일하게 지원되는 작업입니다.

  • 행 삭제(V2)
  • SQL 쿼리 실행(V2)
  • 행 가져오기(V2)
  • 행 가져오기(V2)
  • 테이블 가져오기(V2)
  • 행 삽입(V2)
  • 행 업데이트(V2)
  • 저장 프로시저 실행(V2)

• 이 목록 외부의 모든 작업은 "403 권한 없음" 오류를 반환합니다.

• 온-프레미스 데이터 게이트웨이는 지원되지 않습니다.

• Microsoft Entra ID 통합 인증을 사용하는 경우 데이터베이스 이름을 사용자 지정 값으로 수동으로 입력하세요.

작업의 알려진 문제 및 제한 사항

간단한 설명	Operations	긴 설명
작업 출력에서 결정적 결과 가져오기	행 가져오기(V2)	작업 출력에서 Order By 결정적 결과를 얻으려면 매개 변수를 사용하는 것이 좋습니다. 지정되지 않은 경우 Order By 기본 키 또는 고유 키는 기본적으로 SQL Server에서 사용됩니다. 비결정적 결과는 페이지 매김을 사용할 때 작업 출력에서 레코드를 복제하는 것과 같은 문제를 일으킬 수 있습니다. SQL 뷰는 SQL Server 자체의 제한인 기본 키를 지원하지 않습니다.
SQL 쿼리 제한 지원 실행	SQL 쿼리 실행(V2)	온-프레미스 SQL Server에는 지원되지 않습니다.
일반적인 CRUD 요구 사항	행 가져오기(V2) 행 가져오기(V2) 행 업데이트(V2) 행 삭제(V2)	문자열 값은 Azure SQL 인스턴스 사용의 경우 잘립니다. 따라서 빈 문자열은 빈 문자열로 변환됩니다. INSERT 및 UPDATE 작업의 경우 커넥터는 업데이트된 행을 반환합니다. 이렇게 하려면 연결에 SQL Server에서 데이터를 읽을 수 있는 권한도 있어야 합니다. 다음 작업에는 기본 키가 필요합니다. - GetItem - PatchItem - DeleteItem
집계 변환 매개 변수 지원	행 가져오기(V2)	다음 집계 변환만 지원됩니다. - 필터: 입력 집합 필터링을 허용합니다. 와 동일한 식을 지원합니다 $filter. 예: filter(ColName1 eq 1). - aggregate: 다음 방법 중 하나를 사용하여 집계를 허용합니다. averagemaxminsumcountdistinct 예: aggregate(ColName2 with max as MaxValue). 여러 연산자를 슬래시로 구분하여 연속적으로 적용됨을 표현할 수 있습니다. 즉, 각 변환의 결과는 다음 변환에 대한 입력입니다. 예: filter(ColName1 eq 4)/aggregate(ColName2 with sum as MaxWorkItemId).
SQL 쿼리를 실행할 때 정식 매개 변수의 데이터 형식이 재정의됨	SQL 쿼리 실행 [사용되지 않음] SQL 쿼리 실행(V2)	SQL 쿼리에서 정식 매개 변수를 정의할 때 입력한 데이터 형식은 커넥터의 기본 구현에서 매개 변수의 제공된 값을 통해 형식을 결정하기 때문에 재정의될 수 있습니다.
정식 매개 변수를 사용하는 IN 연산자는 전달된 값을 별도로 정의해야 합니다.	SQL 쿼리 실행(V2)	IN 연산자를 사용하여 정식 매개 변수를 사용하는 경우 전달된 모든 값은 여러 쉼표로 구분된 값을 포함하는 단일 형식 매개 변수가 아니라 별도로 정의해야 합니다. 예: SELECT * FROM tableName WHERE columnName IN (@formalParameterA, @formalParameterB, @formalParameterC).
Azure Sql DataWareHouse DB를 사용한 오류	행 삽입(V2)	Power Apps에서 Azure SQL Datawarehouse DB를 사용하면 DB에서 커넥터 실행의 구문이 일치하지 않아 오류가 발생합니다. Power Automate에서 Azure SQL Datawarehouse 커넥터를 사용하여 흐름을 만들거나, PowerApps에서 트리거하거나, 쿼리를 구성하고 , SQL 쿼리 실행(V2) 작업에서 사용하세요.

트리거의 알려진 문제 및 제한 사항

비고

흐름을 끄고 켜면 트리거 상태가 다시 설정되지 않습니다.

간단한 설명	Operations	긴 설명
항목 수정: 행 작업	항목이 수정되는 경우(V2)	INSERT 및 UPDATE 행 작업 모두에서 발생합니다.
항목 수정: 열 요구 사항	항목이 수정되는 경우(V2)	ROWVERSION 열이 필요합니다.
항목 만들기: 열 요구 사항	항목이 만들어지는 경우(V2)	IDENTITY 열이 필요합니다.
항목 만들기	항목이 만들어지는 경우(V2)	최근 삽입된 행의 ID 열 값을 임계값(트리거 상태)으로 사용하여 나중에 새로 삽입된 행을 식별합니다. 논리는 모든 새 행의 ID가 이전 행보다 커야 한다고 가정합니다. 따라서 명시적 t-sql 명령 또는 테이블 잘림으로 인해 테이블에 대한 ID 시퀀스가 다시 설정되는 경우 트리거 논리는 기존 흐름에 대한 새 행을 건너뜁니다. 가능한 두 가지 해결 방법은 다음과 같습니다. 먼저 트리거 작업 카드(예: 이름 바꾸기, 매개 변수 업데이트 또는 새 연결 추가)를 업데이트하여 흐름 트리거 상태를 다시 설정하고 변경 내용을 저장할 수 있습니다. 또는 다음 방법을 사용하여 대상 테이블 ID 시퀀스를 복원할 수 있습니다.

일반적인 알려진 문제 및 제한 사항

• 테이블에 SQL 서버 쪽 트리거를 정의한 경우에는 테이블 삽입 및 업데이트가 작동하지 않습니다.

  이 문제를 해결하려면 다음 옵션이 있습니다.

  • 저장 프로시저 또는 네이티브 쿼리를 사용합니다.
  • SQL 테이블에서 트리거를 제거합니다.

• 온-프레미스 SQL 서버에서 SQL 커넥터를 사용하는 경우 다음과 같은 제한 사항이 적용됩니다.

  • 온-프레미스 SQL Server에 대해 지원되는 최소 버전은 SQL Server 2005입니다.
  • 요청 크기 제한은 온-프레미스 SQL Server를 통해 2MB입니다.
  • 응답 크기 제한은 온-프레미스 SQL Server를 통해 8MB입니다.

• 게이트웨이를 통해 온-프레미스 SQL 서버에서 저장 프로시저를 호출하는 경우 다음과 같은 제한 사항이 적용됩니다.

  • 매개 변수의 OUTPUT 출력 값은 반환되지 않습니다. 매개 변수에 대한 OUTPUT 입력 값을 계속 지정할 수 있습니다.
  • ResultSets 값이 형식화되지 않았습니다.
  • 반환 값을 사용할 수 없습니다.
  • 첫 번째 결과 집합만 반환됩니다.
  • Dynamics 스키마는 결과 집합에 대해 지원되지 않습니다.

• 다음 데이터 형식은 쿼리 옵션 조건자로 사용할 수 없습니다.

  • date
  • datetime
  • datetime2
  • smalldatetime

• 강제 암호화 설정은 지원되지 않습니다. 기본적으로 SQL Database 및 SQL Managed Instance는 TLS(전송 계층 보안)를 사용하여 이동 중인 데이터를 암호화하여 고객 데이터를 보호합니다. 자세한 내용은 Azure SQL 보안 개요를 참조하세요.

• 여러 결과 집합 지원은 현재 SQL 네이티브 쿼리 실행에 대해 제한됩니다. 첫 번째 빈 하나의 결과 집합까지의 결과 집합만 반환됩니다.

  이 문제를 해결하려면 저장 프로시저를 사용합니다.

• SQL 쿼리 및 저장 프로시저를 실행한 후 결과 집합 스키마에는 비어 있지 않은 고유한 열 이름이 포함되어야 합니다.

• 내부 SELECT 문과 같은 일부 결과 집합을 반환하는 저장 프로시저 내의 모든 작업의 경우 결과 집합 스키마에는 비어 있지 않은 고유한 열 이름이 포함되어야 합니다.

• SQL 쿼리 또는 저장 프로시저의 실행 시간이 110초를 초과하면 작업 시간이 초과됩니다.

  Azure Logic Apps에서 이 제한을 해결하며 장기 실행 저장 프로시저를 실행하는 방법을 알아보려면 Logic Apps에서 장기 실행 SQL 저장 프로시저를 참조하세요.

• Azure Logic Apps에서는 ISE(통합 서비스 환경) 내에서만 SQL Server의 프라이빗 엔드포인트에 액세스할 수 있습니다. 자세한 내용은 Azure 가상 네트워크에 대한 액세스를 참조하세요.

• 필터가 많은 쿼리를 만들 때 다음과 같은 오류가 발생할 수 있습니다. "OData 쿼리 구문 트리가 노드 개수 제한을 '100'으로 초과했습니다. OData 쿼리 매개 변수 식을 간소화해 보세요." 이 문제를 방지하려면 필터링 조건을 최적화하여 해당 수를 줄입니다(예: 범위 사용).

• 대상 테이블 필드(e.g. xml 또는 텍스트 데이터 형식)에 대량의 데이터(30MB 이상)를 저장하지 않는 것이 좋습니다. 이로 인해 작업 및 트리거의 성능이 저하되어 504개의 시간 제한 오류가 발생할 수 있습니다. 상대적으로 작은 필드만 포함하고 큰 출력 데이터 필드를 방지하려면 '쿼리 선택' 매개 변수를 사용하세요. 또는 Azure Blob Storage와 같은 특수 파일 스토리지를 대신 사용하세요.

• OUTPUT 절 지원 부족으로 인해 Azure Synapse 원본에 대해 CRUD 작업이 지원되지 않습니다. 대신 전용 Azure SQL Data Warehouse 커넥터를 사용하는 것이 좋습니다.

• Power Platform 및 Logic Apps 탐색기 보기는 10,000개의 테이블 목록 크기로 제한됩니다.

• OData 표준 식별자를 준수하지 않는 데이터베이스 스키마는 지원되지 않습니다(숫자로 시작하는 열 이름, 서로게이트 쌍 문자 포함 등). 고객은 뷰를 사용하여 열의 이름을 추상화하거나 SQL 확장 속성을 사용하여 보조 평면 문자를 사용하여 데이터베이스 스키마와 분리된 상태로 유지할 수 있습니다. 테이블의 열에 확장 속성 추가를 참조하세요.

• SQL 커넥터를 가상 테이블의 데이터 원본으로 사용하는 경우 서버 및 데이터베이스 값은 원본 데이터 세트와 사용 중인 연결 간에 일치해야 합니다. SQL 인증을 사용하는 경우 연결에 이미 서버 및 데이터베이스 값이 포함되므로 데이터 세트 값을 기본값으로 설정할 수 있습니다. 데이터 세트 연결 값이 명시적으로 명시된 경우 연결 값과 일치해야 합니다. 그렇지 않으면 "문제가 발생했습니다. 테이블을 열 수 없습니다. 다시 로드하거나 다시 열어 보세요." 또는 "잘못된 데이터 원본"이 발생할 수 있습니다.

• Power Automate 흐름에서 사용되는 보기에 스키마 변경이 발생하면 업데이트된 뷰에 대해 새 연결이 만들어질 때까지 트리거가 실행되지 않을 수 있습니다. 업데이트된 뷰에 대해 트리거를 다시 설정하기에는 연결 새로 고침만으로는 충분하지 않습니다.

• TDS(테이블 형식 데이터 스트림) 프로토콜 8.0은 현재 SQL 커넥터에서 지원되지 않습니다.

특수 제한 제한

• 경우에 따라 SQL 커넥터의 제한 제한은 다릅니다. 다음 표에서 네이 티브 작업에는 SQL 저장 프로시저 및 SQL 쿼리가 포함됩니다. CRUD 는 만들기, 읽기, 업데이트 및 삭제 작업을 의미합니다.

• 아래 제한과 함께 connectionID 수준 제한은 지정된 기간 동안 이전 요청에서 소요된 총 시간에 따라 적용됩니다.

서비스	환경	Operations	이름	호출	갱신 기간(초)
Logic Apps 및 Power Automate	공유 환경	Native	연결당 API 호출	500	10
Logic Apps 및 Power Automate	공유 환경	CRUD	연결당 API 호출	100	10
Logic Apps 및 Power Automate	공유 환경	Native	연결당 동시 호출	200	-
Logic Apps 및 Power Automate	공유 환경	CRUD	연결당 동시 호출	125	-
파워 앱스 (Power Apps)	공유 환경	All	사용자당 API 호출	300	30
파워 앱스 (Power Apps)	공유 환경	All	연결당 동시 호출	125	-

비고

동시 호출은 특정 연결에서 수행할 수 있는 진행 중인 요청 수입니다. 예를 들어 Azure Logic Apps 네이티브 호출을 사용하면 단일 연결에서 200개의 동시 호출을 수행할 수 있습니다. 모든 200개 호출이 여전히 실행 중인 경우 후속 호출은 429 오류를 반환합니다. 호출에 임의 시간이 걸릴 수 있으므로 시간 제한이 없습니다. 그러나 호출 제한의 요점은 단일 연결에서 너무 많은 장기 실행 쿼리를 방지하고 다른 연결에 부정적인 영향을 미치는 것입니다.

예를 들어 연결에서 동시에 200개의 호출을 수행하고 각 호출을 실행하는 데 50초가 걸리는 경우 다른 모든 호출은 다음 50초 동안 429 오류로 실패합니다. 하나 이상의 쿼리 실행이 완료되고 결과가 반환되면 후속 호출이 처리됩니다.

Power Apps 데이터 형식 매핑

Power Apps SQL 설명서를 참조하세요.

SQL Server에 위임할 수 있는 Power Apps 함수 및 작업

Power Apps SQL 위임 설명서를 참조하세요.

작업의 공식 매개 변수

SQL 쿼리 [사용되지 않음]을 실행하고V2(SQL 쿼리 실행) 작업을 수행하면 공식 매개 변수를 사용할 수 있습니다. 키-값 쌍으로 정의됩니다. 여기서 key 는 매개 변수 이름이고 value SQL 데이터 형식(예: INT 또는 NVARCHAR(255).)입니다. 이름 및 데이터 형식을 정의한 후 값에 대한 새 입력 필드가 표시됩니다.

V1 작업을 해당하는 V2로 마이그레이션

V1 작업에서 해당 V2로 마이그레이션하려면 다음 단계를 수행합니다.

중요합니다

마이그레이션을 시작하기 전에 항상 논리 앱, Power Automate 흐름 또는 Power App의 복사본을 저장하여 백업을 수행합니다.

비고

모든 V2 작업에는 두 개의 추가 매개 변수가 Server NameDatabase Name있습니다. 이렇게 하면 V2 작업에서 Microsoft Entra ID 인증을 지원할 수 있습니다.

작업 유형	V1 작업	해당하는 V2 작업
조치	행 삭제 [사용되지 않음]	행 삭제(V2)
조치	SQL 쿼리 실행 [사용되지 않음]	SQL 쿼리 실행(V2)
조치	저장 프로시저 실행	저장 프로시저 실행(V2)
조치	행 가져오기 [사용되지 않음]	행 가져오기(V2)
조치	행 가져오기 [사용되지 않음]	행 가져오기(V2)
조치	행 삽입 [사용되지 않음]	행 삽입(V2)
조치	연결에 의해 노출되는 테이블을 나열합니다.[사용되지 않음]	테이블 가져오기(V2)
조치	행 업데이트 [사용되지 않음]	행 업데이트(V2)
Trigger	항목이 만들어지는 경우 [사용되지 않음]	항목이 만들어지는 경우(V2)
Trigger	항목이 수정된 경우 [사용되지 않음]	항목이 수정되는 경우(V2)

V1 작업 식별

파워 오토메이트

Power Automate 작업의 경우 SQL Server 작업을 Code View 열고 값을 확인합니다 host.operationId . 값이 위에 나열된 SQL Server V1 작업 ID 중 하나와 일치하는 경우 해당 작업을 해당 V2로 마이그레이션해야 합니다.

예를 들어 PatchItem 작업을 .로 마이그레이션해야 합니다 PatchItem_V2.

로직 앱스

하나 이상의 SQL Server V1 작업이 포함된 Logic Apps에 대한 개요를 보려면 다음을 수행합니다.

1. Azure Portal 열기

2. Azure Resource Graph 탐색기 열기

3. 자리 표시자에 구독 ID를 입력하고 아래 쿼리를 실행하여 주의가 필요한 Logic Apps 및 각 작업의 SQL Server V1 작업 수를 요약합니다.

   • V1 작업으로 Logic Apps를 식별하는 Azure Resource Graph Explorer 스크립트입니다.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend actionsJson=propertiesJson["definition"]["actions"]
     | mv-expand actionsJson
     | where notnull(actionsJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(actionsJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend actionConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(actionsJson))
     | where notnull(actionConnectionName)
     | parse actionConnectionName with "@parameters('$connections')['"parsedActionConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedActionConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, actionsJson
     | summarize v1ActionCount = count() by resourceGroup, logicAppName = name
     

   • V1 트리거를 사용하여 Logic Apps를 식별하는 Azure Resource Graph Explorer 스크립트입니다.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend triggersJson=propertiesJson["definition"]["triggers"]
     | mv-expand triggersJson
     | where notnull(triggersJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(triggersJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend triggerConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(triggersJson))
     | where notnull(triggerConnectionName)
     | parse triggerConnectionName with "@parameters('$connections')['"parsedTriggerConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedTriggerConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, triggersJson
     | summarize v1TriggerCount = count() by resourceGroup, logicAppName = name
     

UX에서 V2 작업으로 마이그레이션

Logic Apps 및 Power Automate 자동화 마이그레이션

1. V1 작업이 포함된 논리 앱 또는 Power Automate 흐름을 엽니다.

2. 업데이트하려는 V1 작업 바로 앞이나 후에 작업을 추가합니다.

   

3. SQL Server 커넥터를 클릭하고 마이그레이션 중인 작업에 해당하는 V2를 찾습니다.

   

4. V2 작업에서 사용할 연결을 선택합니다.

   팁 (조언)

   V2 작업은 Microsoft Entra ID 인증 유형을 지원합니다. Logic Apps는 Azure Logic Apps도 V2 작업에서 관리 ID 인증 을 지원합니다.

   인증 섹션에서 자세히 알아보세요.

5. 서버 이름을 입력합니다.

   • 사용 Windows Authentication 중이거나 SQL Server Authentication드롭다운에서 서버 이름을 선택합니다.

     

   • 사용하거나 Managed Identity 인증 유형을 사용하는 Microsoft Entra IDService principal경우 드롭다운에서 "사용자 지정 값 입력"을 클릭한 다음 서버 이름을 입력합니다.

     

6. 드롭다운에서 데이터베이스를 선택하여 데이터베이스를 입력합니다.

   

7. 매개 변수가 V1 작업과 같도록 나머지 매개 변수를 입력합니다.

8. V1 작업 구성을 완료한 후 V2 작업을 삭제합니다.

   

   중요합니다

   V1 작업을 삭제하면 V1의 모든 동적 콘텐츠가 삭제됩니다. V2 동적 콘텐츠를 다시 추가해야 합니다.

Power Apps 마이그레이션

1. 업데이트해야 하는 앱을 엽니다.

2. 모든 SQL 데이터 원본을 삭제합니다.

   비고

   삭제된 데이터 원본을 사용하는 수식에는 오류가 표시되며, 이는 예상되며 다음 단계에서 수정됩니다.

   

3. 설정에서 예정된 기능 탭을 열고 검색 상자에 "SQL"을 입력합니다. "향상된 Microsoft SQL Server 커넥터 사용" 기능이 제공됩니다.

   

4. "향상된 Microsoft SQL Server 커넥터 사용" 기능을 켭니다.

   비고

   이 기능은 기본적으로 모든 새 Power Apps에 대해 설정됩니다.

   

5. 데이터 원본을 읽었습니다.

   

6. DateTime 데이터 형식을 처리하는 테이블에서 특별히 앱 동작을 확인합니다.

7. 앱을 저장합니다.

Azure Logic Apps에서 코드 보기를 통해 작업 마이그레이션

더 복잡한 시나리오의 경우 워크플로의 정의를 업데이트하여 작업을 마이그레이션할 수 있습니다.

1. 논리 앱에서 마이그레이션해야 하는 작업(트리거 및/또는 작업)의 이름을 식별합니다.

2. 수정할 논리 앱의 디자이너를 열고 "코드 보기"를 클릭합니다.

   

3. 마이그레이션해야 하는 각 작업에 대해 다음을 수행합니다.

   1. 작업 또는 트리거 경로 속성 찾기
   2. 경로 속성/v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/에서 .로 대체 /datasets/default/ 합니다.

4. 모든 작업이 업데이트되면 "디자이너"를 클릭합니다.

   

5. 모든 작업이 성공적으로 마이그레이션되었는지 확인합니다.

   • 서버 및 데이터베이스 이름은 연결 값으로 채워져야 합니다.
   • 다른 모든 매개 변수도 채워야 합니다.

   

6. 논리 앱을 저장하고 테스트합니다.

팁 (조언)

원하는 경우 작업이 V2 버전으로 마이그레이션되면 작업의 이름과 연결을 업데이트할 수 있습니다.

다음은 행 가져오기 [사용되지 않음]을 마이그레이션하는 예제입니다.

1. "코드 뷰"를 엽니다.

2. "행 가져오기 [사용되지 않음]" 작업을 찾습니다.

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/datasets/default/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

3. 경로의 데이터 세트 세그먼트를 위에서 제공된 대체 항목으로 업데이트합니다.

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

4. "디자이너"를 클릭하여 초기 보기로 돌아가서 작업이 올바르게 채워졌 있는지 확인합니다.

흐름 정의 편집을 통해 작업 마이그레이션

1. 논리 앱에서 마이그레이션해야 하는 작업(트리거 및/또는 작업)의 이름을 식별합니다.

2. 흐름을 패키지(ZIP)로 내보냅니다.

   

3. ZIP 파일을 추출합니다.

4. ZIP이 추출된 폴더를 엽니다.

5. Microsoft.Flow그런 다음 flowsGUID 명명된 폴더로 이동합니다.

6. 텍스트 편집기에서 definition.json 파일을 엽니다.

   • 가독성을 향상하려면 JSON의 서식을 지정합니다.

7. 마이그레이션해야 하는 각 작업에 대해 다음을 수행합니다.

   1. 작업 또는 트리거 속성 찾기

   2. 속성을 해당하는 V2로 업데이트 inputs.host.operationId 합니다. 작업 설명서에서 값을 찾을 수 있습니다.

      

   3. 다음 두 가지 속성에 inputs.parameters 추가합니다.

      • server 값이 있는 경우 default
      • database 값이 있는 경우 default

8. definition.json 파일 저장

9. manifest.json 및 Microsoft.Flow가 있는 위치로 다시 이동합니다.

10. Microsoft.Flow와 manifest.json모두 선택하고 ZIP 파일로 압축합니다.

    중요합니다

    새 ZIP 파일에 원래 ZIP 파일과 정확히 동일한 파일 및 폴더 구조가 있는지 확인합니다.

    Microsoft.Flow 폴더와 manifest.json 파일은 새 ZIP 파일의 루트에 있어야 합니다 . 동일한 구조를 갖지 못하면 패키지를 업로드할 때 오류가 발생합니다.

    

11. Power Automate에서 흐름으로 이동합니다.

12. 패키지를 가져와 업데이트된 흐름을 가져옵니다. 새로 만든 ZIP을 선택하고 패키지를 업로드합니다.

    

13. 가져오기 설정(새 설정 가져오기/만들기)을 선택하고 흐름에서 사용할 연결을 선택합니다.

14. 가져오기가 완료되면 새/업데이트된 흐름을 엽니다.

15. 작업이 업데이트되었는지 확인

• 서버 및 데이터베이스 이름은 연결 값으로 채워져야 합니다.

• 다른 모든 매개 변수도 채워야 합니다.

  

팁 (조언)

원하는 경우 작업이 V2 버전으로 마이그레이션되면 UX에서 작업의 이름과 연결을 업데이트할 수 있습니다.

다음은 SQL 쿼리 실행 [사용되지 않음]을 마이그레이션하는 예제입니다.

1. "코드 뷰"를 엽니다.

2. "SQL 쿼리 실행 [사용되지 않음]" 작업을 찾습니다.

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery"
         },
         "parameters": {
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   

3. 작업 ID를 해당하는 V2 작업 ID로 업데이트한 다음, 위의 지시와 같은 값으로 서버 및 데이터베이스 매개 변수를 default 추가합니다.

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery_V2"
         },
         "parameters": {
           "server": "default",
           "database": "default",
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   
   

중요합니다

Microsoft Entra ID 통합(Azure Commercial) 연결은 기본적으로 GCC(미국 정부) 환경에서 사용하지 않도록 설정됩니다. 이러한 유형의 연결을 사용하도록 설정하려면 테넌트 관리자가 Power Platform 관리 센터에서 Azure Commercial에 연결 설정을 사용하도록 설정해야 합니다.

이 설정을 켜면 Power Platform 미국 정부 규정 준수 경계 외부에서 데이터를 작동하고 전송하는 Azure Commercial의 리소스에 연결할 수 있습니다. 이는 Power Platform 커넥터의 GCC 클라우드 버전에서 상용 리소스에 액세스할 수 있도록 특별히 사용됩니다.

Microsoft Entra ID 통합(Azure Commercial)은 GCC(미국 정부) 환경에서 Azure 상업용 리소스로 작동하는 유일한 인증 유형입니다.

Azure 상용 인증은 기본적으로 사용하지 않도록 설정됨:

Power Platform 관리 센터의 Azure Commercial에 연결 설정:

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.

클라이언트 인증서 인증	PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공	모든 지역	공유 가능
Microsoft Entra ID 통합	Microsoft Entra ID를 사용하여 SQL 데이터베이스에 액세스합니다.	GCC(미국 정부)를 제외한 모든 지역	공유할 수 없음
Microsoft Entra ID 통합(Azure Commercial)	Microsoft Entra ID를 사용하여 Azure Commercial에서 SQL 데이터베이스에 액세스합니다.	GCC(미국 정부)	공유할 수 없음
Microsoft Entra ID 통합(Azure Government)	Microsoft Entra ID를 사용하여 Azure Government의 SQL 데이터베이스에 액세스합니다.	GCC(미국 정부)	공유할 수 없음
서비스 주체(Microsoft Entra ID 애플리케이션)	Microsoft Entra ID 애플리케이션을 사용하여 SQL 데이터베이스에 액세스합니다.	모든 지역	공유 가능
SQL Server 인증	계정 이름 및 암호를 사용하여 SQL 데이터베이스에 액세스합니다.	모든 지역	공유 가능
Windows 인증	온-프레미스 Microsoft Entra ID 계정 이름 및 암호를 사용하여 SQL 데이터베이스에 액세스합니다.	모든 지역	공유 가능
Windows 인증(공유가 아닌)	온-프레미스 Microsoft Entra ID 계정 이름 및 암호를 사용하여 SQL 데이터베이스에 액세스합니다.	모든 지역	공유할 수 없음
기본값 [사용되지 않음]	이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.	모든 지역	공유할 수 없음

클라이언트 인증서 인증

인증 ID: certOauth

적용 가능: 모든 지역

PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름	유형	Description	필수
임차인	문자열		진실
클라이언트 ID	문자열	Microsoft Entra ID 애플리케이션의 클라이언트 ID
클라이언트 인증서 비밀	클라이언트 인증서	이 애플리케이션에서 허용하는 클라이언트 인증서 비밀	진실

Microsoft Entra ID 통합

인증 ID: oauth

적용 가능: GCC(미국 정부)를 제외한 모든 지역

Microsoft Entra ID를 사용하여 SQL 데이터베이스에 액세스합니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

Microsoft Entra ID 통합(Azure Commercial)

인증 ID: oauthCom

적용 가능: GCC(미국 정부) 전용

Microsoft Entra ID를 사용하여 Azure Commercial에서 SQL 데이터베이스에 액세스합니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

Microsoft Entra ID 통합(Azure Government)

인증 ID: oauth

적용 가능: GCC(미국 정부) 전용

Microsoft Entra ID를 사용하여 Azure Government의 SQL 데이터베이스에 액세스합니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

서비스 주체(Microsoft Entra ID 애플리케이션)

인증 ID: oauthSP

적용 가능: 모든 지역

Microsoft Entra ID 애플리케이션을 사용하여 SQL 데이터베이스에 액세스합니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름	유형	Description	필수
임차인	문자열		진실
클라이언트 ID	문자열		진실
클라이언트 암호	시큐어스트링 (보안 문자열)		진실

SQL Server 인증

인증 ID: sqlAuthentication

적용 가능: 모든 지역

계정 이름 및 암호를 사용하여 SQL 데이터베이스에 액세스합니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름	유형	Description	필수
SQL Server 이름	문자열	SQL Server의 이름 지정(서버[:p ort])	진실
SQL 데이터베이스 이름	문자열	SQL 데이터베이스 이름	진실
사용자 이름	시큐어스트링 (보안 문자열)	사용자 이름 자격 증명	진실
암호	시큐어스트링 (보안 문자열)	암호 자격 증명	진실
Gateway	gatewaySetting	온-프레미스 게이트웨이(자세한 내용은 참조 https://docs.microsoft.com/data-integration/gateway )

Windows 인증

인증 ID: windowsAuthentication

적용 가능: 모든 지역

온-프레미스 Microsoft Entra ID 계정 이름 및 암호를 사용하여 SQL 데이터베이스에 액세스합니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름	유형	Description	필수
SQL Server 이름	문자열	SQL Server의 이름 지정(서버[:p ort])	진실
SQL 데이터베이스 이름	문자열	SQL 데이터베이스 이름	진실
사용자 이름	시큐어스트링 (보안 문자열)	사용자 이름 자격 증명	진실
암호	시큐어스트링 (보안 문자열)	암호 자격 증명	진실
Gateway	gatewaySetting	온-프레미스 게이트웨이(자세한 내용은 참조 https://docs.microsoft.com/data-integration/gateway )	진실

Windows 인증(공유가 아닌)

인증 ID: windowsAuthenticationNonShared

적용 가능: 모든 지역

온-프레미스 Microsoft Entra ID 계정 이름 및 암호를 사용하여 SQL 데이터베이스에 액세스합니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름	유형	Description	필수
사용자 이름	시큐어스트링 (보안 문자열)	사용자 이름 자격 증명	진실
암호	시큐어스트링 (보안 문자열)	암호 자격 증명	진실
Gateway	gatewaySetting	온-프레미스 게이트웨이(자세한 내용은 참조 https://docs.microsoft.com/data-integration/gateway )	진실

기본값 [사용되지 않음]

적용 가능: 모든 지역

이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름	유형	Description	필수
SQL Server 이름	문자열	SQL Server 이름	진실
SQL 데이터베이스 이름	문자열	SQL 데이터베이스 이름	진실
인증 유형	문자열	데이터베이스에 연결하는 인증 유형
사용자 이름	시큐어스트링 (보안 문자열)	사용자 이름 자격 증명	진실
암호	시큐어스트링 (보안 문자열)	암호 자격 증명	진실
Gateway	gatewaySetting	온-프레미스 게이트웨이(자세한 내용은 참조 https://docs.microsoft.com/data-integration/gateway )

제한 한도

Name	호출	갱신 기간
연결당 API 호출	100	10초

동작

SQL 쿼리 실행(V2)	SQL 쿼리 실행(V2)
SQL 쿼리 실행 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 SQL 쿼리 실행(V2) 을 사용하세요. SQL 쿼리 실행
연결에 의해 노출되는 테이블을 나열합니다.[사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 테이블 가져오기(V2) 를 사용하세요. 연결에 의해 노출되는 테이블을 나열합니다.
저장 프로시저 실행	이 작업은 저장 프로시저를 실행합니다.
저장 프로시저 실행(V2)	이 작업은 저장 프로시저를 실행합니다.
테이블 가져오기(V2)	이 작업은 데이터베이스에서 테이블을 가져옵니다.
파워 쿼리를 사용하여 데이터 변환	파워 쿼리를 사용하여 데이터를 변환합니다. 참고: 이 작업은 SQL Microsoft Entra ID를 사용하여 연결할 때 작동하지 않습니다.
행 가져오기(V2)	이 작업은 테이블에서 행을 가져옵니다.
행 가져오기(V2)	이 작업은 테이블에서 행을 가져옵니다.
행 가져오기 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 행 가져오기(V2) 를 사용하세요. 이 작업은 테이블에서 행을 가져옵니다.
행 가져오기 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 행 가져오기(V2) 를 사용하세요. 이 작업은 테이블에서 행을 가져옵니다.
행 삭제(V2)	이 작업은 테이블에서 행을 삭제합니다.
행 삭제 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 행 삭제(V2) 를 사용하세요. 이 작업은 테이블에서 행을 삭제합니다.
행 삽입(V2)	이 작업은 테이블에 새 행을 삽입합니다.
행 삽입 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 행 삽입(V2) 을 사용하세요. 이 작업은 테이블에 새 행을 삽입합니다.
행 업데이트(V2)	이 작업은 테이블의 기존 행을 업데이트합니다.
행 업데이트 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 업데이트 행(V2) 을 사용하세요. 이 작업은 테이블의 기존 행을 업데이트합니다.

SQL 쿼리 실행(V2)

작업 ID:

ExecutePassThroughNativeQuery_V2

SQL 쿼리 실행(V2)

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름
Query	query	True	dynamic	쿼리 본문

반환

이 작업의 출력은 동적입니다.

SQL 쿼리 실행 [사용되지 않음]

작업 ID:

ExecutePassThroughNativeQuery

이 작업은 더 이상 사용되지 않습니다. 대신 SQL 쿼리 실행(V2) 을 사용하세요.

SQL 쿼리 실행

매개 변수

Name	키	필수	형식	Description
Query	query	True	dynamic	쿼리 본문

반환

이 작업의 출력은 동적입니다.

연결에 의해 노출되는 테이블을 나열합니다.[사용되지 않음]

작업 ID:

GetTables

이 작업은 더 이상 사용되지 않습니다. 대신 테이블 가져오기(V2) 를 사용하세요.

연결에 의해 노출되는 테이블을 나열합니다.

반환

테이블 목록을 나타냅니다.

몸

TablesList

저장 프로시저 실행

작업 ID:

ExecuteProcedure

이 작업은 저장 프로시저를 실행합니다.

매개 변수

Name	키	필수	형식	Description
프로시저 이름	procedure	True	string	저장 프로시저의 이름
매개 변수 목록	parameters	True	dynamic	저장 프로시저에 대한 입력 매개 변수

반환

이 작업의 출력은 동적입니다.

저장 프로시저 실행(V2)

작업 ID:

ExecuteProcedure_V2

이 작업은 저장 프로시저를 실행합니다.

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름
프로시저 이름	procedure	True	string	저장 프로시저의 이름
매개 변수 목록	parameters	True	dynamic	저장 프로시저에 대한 입력 매개 변수

반환

이 작업의 출력은 동적입니다.

테이블 가져오기(V2)

작업 ID:

GetTables_V2

이 작업은 데이터베이스에서 테이블을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름

반환

테이블 목록을 나타냅니다.

몸

TablesList

파워 쿼리를 사용하여 데이터 변환

작업 ID:

SqlExecutePassThroughPowerQuery

파워 쿼리를 사용하여 데이터를 변환합니다. 참고: 이 작업은 SQL Microsoft Entra ID를 사용하여 연결할 때 작동하지 않습니다.

매개 변수

Name	키	필수	형식	Description
query	query		mquery	쿼리 텍스트

반환

이 작업의 출력은 동적입니다.

행 가져오기(V2)

작업 ID:

GetItem_V2

이 작업은 테이블에서 행을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름
테이블 이름	table	True	string	SQL 테이블의 이름
행 ID	id	True	string	검색할 행의 고유 식별자

반환

이 작업의 출력은 동적입니다.

행 가져오기(V2)

작업 ID:

GetItems_V2

이 작업은 테이블에서 행을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름
테이블 이름	table	True	string	SQL 테이블의 이름
집계 변환	$apply		string	ODATA 집계 변환의 시퀀스
필터 쿼리	$filter		string	반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123).
주문 기준	$orderby		string	항목의 순서를 지정하기 위한 ODATA orderBy 쿼리입니다.
개수 건너뛰기	$skip		integer	건너뛸 항목 수(기본값 = 0)입니다.
상위 개수	$top		integer	검색할 총 항목 수입니다(기본값 = 모두).
쿼리 선택	$select		string	항목에서 검색할 특정 필드(기본값 = 모두).

반환

이 작업의 출력은 동적입니다.

행 가져오기 [사용되지 않음]

작업 ID:

GetItem

이 작업은 더 이상 사용되지 않습니다. 대신 행 가져오기(V2) 를 사용하세요.

이 작업은 테이블에서 행을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
테이블 이름	table	True	string	SQL 테이블의 이름
행 ID	id	True	string	검색할 행의 고유 식별자

반환

이 작업의 출력은 동적입니다.

행 가져오기 [사용되지 않음]

작업 ID:

GetItems

이 작업은 더 이상 사용되지 않습니다. 대신 행 가져오기(V2) 를 사용하세요.

이 작업은 테이블에서 행을 가져옵니다.

매개 변수

Name	키	필수	형식	Description
테이블 이름	table	True	string	SQL 테이블의 이름
집계 변환	$apply		string	ODATA 집계 변환의 시퀀스
필터 쿼리	$filter		string	반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123).
주문 기준	$orderby		string	항목의 순서를 지정하기 위한 ODATA orderBy 쿼리입니다.
개수 건너뛰기	$skip		integer	건너뛸 항목 수(기본값 = 0)입니다.
상위 개수	$top		integer	검색할 총 항목 수입니다(기본값 = 모두).
쿼리 선택	$select		string	항목에서 검색할 특정 필드(기본값 = 모두).

반환

이 작업의 출력은 동적입니다.

행 삭제(V2)

작업 ID:

DeleteItem_V2

이 작업은 테이블에서 행을 삭제합니다.

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름
테이블 이름	table	True	string	테이블 이름
행 ID	id	True	string	삭제할 행의 고유 식별자

행 삭제 [사용되지 않음]

작업 ID:

DeleteItem

이 작업은 더 이상 사용되지 않습니다. 대신 행 삭제(V2) 를 사용하세요.

이 작업은 테이블에서 행을 삭제합니다.

매개 변수

Name	키	필수	형식	Description
테이블 이름	table	True	string	테이블 이름
행 ID	id	True	string	삭제할 행의 고유 식별자

행 삽입(V2)

작업 ID:

PostItem_V2

이 작업은 테이블에 새 행을 삽입합니다.

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름
테이블 이름	table	True	string	테이블 이름
Row	item	True	dynamic	지정된 테이블에 삽입할 행

반환

이 작업의 출력은 동적입니다.

행 삽입 [사용되지 않음]

작업 ID:

PostItem

이 작업은 더 이상 사용되지 않습니다. 대신 행 삽입(V2) 을 사용하세요.

이 작업은 테이블에 새 행을 삽입합니다.

매개 변수

Name	키	필수	형식	Description
테이블 이름	table	True	string	테이블 이름
Row	item	True	dynamic	지정된 테이블에 삽입할 행

반환

이 작업의 출력은 동적입니다.

행 업데이트(V2)

작업 ID:

PatchItem_V2

이 작업은 테이블의 기존 행을 업데이트합니다.

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름
테이블 이름	table	True	string	테이블 이름
행 ID	id	True	string	업데이트할 행의 고유 식별자
Row	item	True	dynamic	업데이트된 값이 있는 행

반환

이 작업의 출력은 동적입니다.

행 업데이트 [사용되지 않음]

작업 ID:

PatchItem

이 작업은 더 이상 사용되지 않습니다. 대신 업데이트 행(V2) 을 사용하세요.

이 작업은 테이블의 기존 행을 업데이트합니다.

매개 변수

Name	키	필수	형식	Description
테이블 이름	table	True	string	테이블 이름
행 ID	id	True	string	업데이트할 행의 고유 식별자
Row	item	True	dynamic	업데이트된 값이 있는 행

반환

이 작업의 출력은 동적입니다.

트리거

항목이 만들어지는 경우(V2)	SQL에서 항목을 만들 때 흐름을 트리거합니다.
항목이 만들어지는 경우 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 항목이 만들어지는 경우(V2)를 사용하세요. SQL에서 항목을 만들 때 흐름을 트리거합니다.
항목이 수정되는 경우(V2)	SQL에서 항목이 수정/삽입될 때 흐름을 트리거합니다.
항목이 수정된 경우 [사용되지 않음]	이 작업은 더 이상 사용되지 않습니다. 대신 항목이 수정될 때(V2)를 사용하세요. SQL에서 항목이 수정/삽입될 때 흐름을 트리거합니다.

항목이 만들어지는 경우(V2)

작업 ID:

GetOnNewItems_V2

SQL에서 항목을 만들 때 흐름을 트리거합니다.

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름
테이블 이름	table	True	string	SQL 테이블의 이름
필터 쿼리	$filter		string	반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123).
상위 개수	$top		integer	검색할 총 항목 수입니다(기본값 = 모두).
주문 기준	$orderby		string	항목의 순서를 지정하기 위한 ODATA orderBy 쿼리입니다.
쿼리 선택	$select		string	항목에서 검색할 특정 필드(기본값 = 모두).

반환

이 작업의 출력은 동적입니다.

항목이 만들어지는 경우 [사용되지 않음]

작업 ID:

GetOnNewItems

이 작업은 더 이상 사용되지 않습니다. 대신 항목이 만들어지는 경우(V2)를 사용하세요.

SQL에서 항목을 만들 때 흐름을 트리거합니다.

매개 변수

Name	키	필수	형식	Description
테이블 이름	table	True	string	SQL 테이블의 이름
필터 쿼리	$filter		string	반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123).
상위 개수	$top		integer	검색할 총 항목 수입니다(기본값 = 모두).
주문 기준	$orderby		string	항목의 순서를 지정하기 위한 ODATA orderBy 쿼리입니다.
쿼리 선택	$select		string	항목에서 검색할 특정 필드(기본값 = 모두).

반환

이 작업의 출력은 동적입니다.

항목이 수정되는 경우(V2)

작업 ID:

GetOnUpdatedItems_V2

SQL에서 항목이 수정/삽입될 때 흐름을 트리거합니다.

매개 변수

Name	키	필수	형식	Description
서버 이름	server	True	string	SQL Server의 이름
데이터베이스 이름	database	True	string	데이터베이스 이름
테이블 이름	table	True	string	SQL 테이블의 이름
필터 쿼리	$filter		string	반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123).
상위 개수	$top		integer	검색할 총 항목 수입니다(기본값 = 모두).
주문 기준	$orderby		string	항목의 순서를 지정하기 위한 ODATA orderBy 쿼리입니다.
쿼리 선택	$select		string	항목에서 검색할 특정 필드(기본값 = 모두).

반환

이 작업의 출력은 동적입니다.

항목이 수정된 경우 [사용되지 않음]

작업 ID:

GetOnUpdatedItems

이 작업은 더 이상 사용되지 않습니다. 대신 항목이 수정될 때(V2)를 사용하세요.

SQL에서 항목이 수정/삽입될 때 흐름을 트리거합니다.

매개 변수

Name	키	필수	형식	Description
테이블 이름	table	True	string	SQL 테이블의 이름
필터 쿼리	$filter		string	반환된 항목을 제한하는 ODATA 필터 쿼리입니다(예: stringColumn eq 'string' OR numberColumn lt 123).
상위 개수	$top		integer	검색할 총 항목 수입니다(기본값 = 모두).
주문 기준	$orderby		string	항목의 순서를 지정하기 위한 ODATA orderBy 쿼리입니다.
쿼리 선택	$select		string	항목에서 검색할 특정 필드(기본값 = 모두).

반환

이 작업의 출력은 동적입니다.

정의

Table

테이블을 나타냅니다.

Name	경로	형식	Description
이름	Name	string	테이블의 이름입니다. 이름은 런타임에 사용됩니다.
디스플레이 이름	DisplayName	string	테이블의 표시 이름입니다.
DynamicProperties	DynamicProperties	object	커넥터에서 클라이언트에 제공하는 추가 테이블 속성입니다.

TablesList

테이블 목록을 나타냅니다.

Name	경로	형식	Description
value	value	array of Table	테이블 목록