다음을 통해 공유


Azure Table Storage (애저 테이블 저장소)

Azure Table Storage는 구조화된 NoSQL 데이터를 클라우드에 저장하여 키/특성 저장소에 스키마 없는 디자인을 제공하는 서비스입니다. Storage 계정에 로그인하여 테이블 등을 만들고, 업데이트하고, 쿼리합니다.

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

서비스 클래스 Regions
Copilot Studio Premium 모든 Power Automate 지역
논리 앱 스탠다드 모든 Logic Apps 지역
Power Apps - 사용할 수 없음
Power Automate Premium 모든 Power Automate 지역
연락처
이름 Microsoft
URL Microsoft LogicApps 지원
Microsoft Power Automate 지원
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://azure.microsoft.com/services/storage/tables/

이 통합을 사용하려면 Azure Storage 계정에 액세스해야 합니다. 자세한 내용은 여기에서 확인할 수 있습니다. 연결을 시도할 때 스토리지 계정 이름 및 스토리지 키를 입력하라는 메시지가 표시됩니다. 스토리지 계정의 이름은 URL에서 찾을 수 있습니다. 예를 들어 URL이면 계정 이름은 "myaccount"입니다 https://myaccount.table.core.windows.net . 계정이 여러 개 있는 경우 사용하려는 계정을 제공하고 만들기를 선택합니다. 만드는 동안 오류가 표시되면 계정 이름과 키를 확인하고 다시 시도합니다. 이제 이 통합을 사용할 준비가 되었습니다.

알려진 문제 및 제한 사항

  1. 논리 앱은 동일한 지역에 있는 경우 방화벽 뒤에 있는 스토리지 계정에 직접 액세스할 수 없습니다. 해결 방법으로 논리 앱과 스토리지 계정을 다른 지역에 둘 수 있습니다. Azure Logic Apps에서 방화벽 뒤의 스토리지 계정으로 액세스를 사용하도록 설정하는 방법에 대한 자세한 내용은 방화벽 뒤에 있는 Access Storage 계정을 참조하세요.

관리 ID 인증 및 Azure Table Storage 커넥터

현재 관리 ID 인증은 Logic Apps에서만 지원됩니다. 아래 단계에 따라 Azure Table Storage 데이터에 연결하는 데 사용합니다.

  1. Azure 관리 ID 만들기
  2. ID에 Azure Blob 리소스에 대한 액세스 권한을 부여합니다. 자세한 내용은 Microsoft Entra ID를 사용하여 Blob에 대한 액세스 권한 부여를 참조하세요.
  3. 사용자 할당 ID를 사용하는 경우 논리 앱을 관리 ID와 연결합니다.
    1. 관리 ID를 사용할 논리 앱으로 이동합니다.
    2. 블레이드의 설정 섹션에서 Identity
    3. 탭으로 User assigned 이동하여 클릭 Add
    4. 사용할 관리 ID를 선택하고 Add

Logic Apps에서 관리 ID로 인증하는 방법에 대한 자세한 내용은 Azure Logic Apps에서 관리 ID를 사용하여 Azure 리소스에 대한 액세스 인증을 참조하세요.

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

현재 인증 파이프라인 제한으로 인해 Microsoft Entra ID 게스트 사용자는 Azure Table Storage에 대한 Microsoft Entra ID 연결에 대해 지원되지 않습니다. Microsoft Entra ID 또는 관리 ID 인증을 사용하는 경우 V2 작업만 지원됩니다. 사용되지 않는 작업은 인증에서 Access Key 계속 작동하지만 Microsoft Entra ID 또는 관리 ID 연결과 함께 사용하면 실패합니다.

테이블 엔드포인트를 사용하여 Azure Table Storage 커넥터에 연결

"액세스 키" 연결을 만들거나 V2 작업을 사용할 때 전체 Azure Storage 테이블 엔드포인트를 입력합니다.

  • "액세스 키" 인증의 경우 매개 변수에 전체 Azure Storage 테이블 엔드포인트를 Azure Storage account name or table endpoint 입력합니다.

    • "액세스 키" 인증과 함께 "V2" 작업을 사용하는 경우 테이블 엔드포인트도 매개 변수에 storageAccountName 제공해야 합니다.
  • "V2" 작업의 경우 매개 변수에 전체 Azure Storage 테이블 엔드포인트를 storageAccountName 입력합니다.

  • 스키마를 포함하여 전체 엔드포인트를 제공해야 합니다. 예를 들면 다음과 같습니다.

    • https://account.table.core.windows.net/
    • https://account-secondary.table.core.windows.net/ (보조 엔드포인트에 연결하는 경우)
    • 상대 경로(예: account.table.core.windows.net)는 거부됩니다.

지정된 스토리지 계정에 대한 Azure Storage 테이블 엔드포인트 가져오기

이 테이블 엔드포인트를 가져오는 방법에는 여러 가지가 있습니다.

  • Azure Portal 사용

    1. Microsoft Azure에서 연결하려는 Azure Storage 계정으로 이동합니다.
    2. 섹션(왼쪽 블레이드)에서 SettingsEndpoints
    3. 테이블 엔드포인트는 텍스트 상자의 table serviceTable service 아래에 있습니다.
  • 스토리지 계정 사용 - 속성 REST API 호출 가져오기

    1. Azure Storage 계정 subscription Idresource group name.
    2. 스토리지 계정으로 이동 - 속성 가져오기
    3. HTTP 호출의 Try it 오른쪽 위 모서리에 있는 단추를 클릭합니다.
    4. 로그인(사용자에게 스토리지 계정에 대한 액세스 권한이 있어야 합니다.)
    5. Azure Storage 계정이 있는 Azure 테넌트 선택
    6. Azure Storage의 계정 이름, 리소스 그룹 이름을 입력하고 스토리지 계정이 있는 구독을 선택합니다.
    7. 클릭 Run
    8. 테이블 엔드포인트는 응답의 table 개체 아래에 primaryEndpoints 있는 속성에 있습니다.

연결을 만드는 중

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

액세스 키 Azure Table Storage에 액세스하려면 Azure Storage 계정 이름(또는 테이블 엔드포인트) 및 액세스 키를 제공합니다. Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역 공유 가능
액세스 키(Azure Government) Azure Table Storage에 액세스하려면 Azure Storage 계정 이름(또는 테이블 엔드포인트) 및 액세스 키를 제공합니다. Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure 정부 및 국방부(DoD)만 공유 가능
클라이언트 인증서 인증 PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공 모든 지역 공유 가능
Logic Apps 앱 관리 ID 관리 ID를 사용하여 연결 만들기 LOGICAPPS만 공유 가능
Microsoft Entra ID 통합 Microsoft Entra ID를 사용하여 Azure Table Storage에 액세스합니다. Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역 공유할 수 없음
Microsoft Entra ID 통합(Azure Government) Microsoft Entra ID를 사용하여 Azure Table Storage에 액세스합니다. Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure 정부 및 국방부(DoD)만 공유할 수 없음
서비스 주체 인증 서비스 주체 인증에 Microsoft Entra ID 애플리케이션을 사용합니다. 모든 지역 공유할 수 없음
기본값 [사용되지 않음] 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. 모든 지역 공유할 수 없음

액세스 키

인증 ID: keyBasedAuth

적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역

Azure Table Storage에 액세스하려면 Azure Storage 계정 이름(또는 테이블 엔드포인트) 및 액세스 키를 제공합니다.

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

이름 유형 Description 필수
Azure Storage 계정 이름 또는 테이블 엔드포인트 문자열 Azure Storage 계정의 이름 또는 테이블 엔드포인트 진실
공유 스토리지 키 시큐어스트링 (보안 문자열) Azure Storage 계정의 공유 스토리지 키 진실

액세스 키(Azure Government)

인증 ID: keyBasedAuth

적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)

Azure Table Storage에 액세스하려면 Azure Storage 계정 이름(또는 테이블 엔드포인트) 및 액세스 키를 제공합니다.

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

이름 유형 Description 필수
Azure Storage 계정 이름 또는 테이블 엔드포인트 문자열 Azure Storage 계정의 이름 또는 테이블 엔드포인트 진실
공유 스토리지 키 시큐어스트링 (보안 문자열) Azure Storage 계정의 공유 스토리지 키 진실

클라이언트 인증서 인증

인증 ID: certOauth

적용 가능: 모든 지역

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

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

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

Logic Apps 관리 ID

인증 ID: managedIdentityAuth

적용 가능: LOGICAPPS만 해당

관리 ID를 사용하여 연결 만들기

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

이름 유형 Description 필수
관리되는 식별 관리되는 ID 관리 ID로 로그인 진실

Microsoft Entra ID 통합

인증 ID: tokenBasedAuth

적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)를 제외한 모든 지역

Microsoft Entra ID를 사용하여 Azure Table Storage에 액세스합니다.

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

Microsoft Entra ID 통합(Azure Government)

인증 ID: tokenBasedAuth

적용 가능: Azure Government 및 GCC(미국 정부) 및 미국 정부(GCC-High)의 Azure Government 및 국방부(DoD)

Microsoft Entra ID를 사용하여 Azure Table Storage에 액세스합니다.

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

서비스 주체 인증

인증 ID: servicePrincipalAuth

적용 가능: 모든 지역

서비스 주체 인증에 Microsoft Entra ID 애플리케이션을 사용합니다.

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

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

기본값 [사용되지 않음]

적용 가능: 모든 지역

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

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

이름 유형 Description 필수
Azure Storage 계정 이름 또는 테이블 엔드포인트 문자열 Azure Storage 계정의 이름 또는 테이블 엔드포인트 진실
공유 스토리지 키 시큐어스트링 (보안 문자열) Azure Storage 계정의 공유 스토리지 키 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 1200 60초

동작

병합 엔터티(V2)

테이블의 엔터티와 데이터를 병합하는 작업입니다.

병합 엔터티 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 병합 엔터티(V2) 를 사용하세요.

테이블의 엔터티와 데이터를 병합하는 작업입니다.

엔터티 가져오기(V2)

이 작업은 테이블의 엔터티를 쿼리합니다.

엔터티 가져오기(V2)

이 작업은 파티션 및 행 키를 기반으로 테이블의 엔터티를 가져옵니다.

엔터티 가져오기 [사용되지 않음]

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

이 작업은 테이블의 엔터티를 쿼리합니다.

엔터티 가져오기 [사용되지 않음]

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

이 작업은 파티션 및 행 키를 기반으로 테이블의 엔터티를 가져옵니다.

엔터티 바꾸기(V2)

테이블의 엔터티를 바꾸는 작업입니다.

엔터티 바꾸기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 엔터티 바꾸기(V2) 를 사용하세요.

테이블의 엔터티를 바꾸는 작업입니다.

엔터티 삭제(V2)

엔터티를 삭제하는 작업입니다.

엔터티 삭제 [사용되지 않음]

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

엔터티를 삭제하는 작업입니다.

엔터티 삽입(V2)

테이블에 엔터티를 추가하는 작업입니다.

엔터티 삽입 [사용되지 않음]

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

테이블에 엔터티를 추가하는 작업입니다.

엔터티 삽입 또는 바꾸기(V2)

테이블의 엔터티를 대체하는 작업으로 필요한 경우 새 엔터티를 만듭니다.

엔터티 삽입 또는 바꾸기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 엔터티 삽입 또는 바꾸기(V2) 를 사용하세요.

테이블의 엔터티를 대체하는 작업으로 필요한 경우 새 엔터티를 만듭니다.

엔터티 삽입 또는 병합(V2)

테이블에 있는 엔터티와 데이터를 병합하여 필요한 경우 새 엔터티를 만드는 작업입니다.

엔터티 삽입 또는 병합 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 엔터티 삽입 또는 병합(V2) 을 사용하세요.

테이블에 있는 엔터티와 데이터를 병합하여 필요한 경우 새 엔터티를 만드는 작업입니다.

테이블 가져오기(V2)

이 작업은 테이블의 메타데이터를 가져옵니다.

테이블 가져오기 [사용되지 않음]

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

이 작업은 테이블의 메타데이터를 가져옵니다.

테이블 나열(V2)

스토리지 계정의 모든 테이블을 나열합니다.

테이블 나열 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 목록 테이블(V2) 을 사용하세요.

이 작업은 계정의 테이블을 나열합니다.

테이블 만들기(V2)

이 작업은 스토리지 계정에 테이블을 추가합니다.

테이블 만들기 [사용되지 않음]

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

이 작업은 스토리지 계정에 테이블을 추가합니다.

테이블 삭제(V2)

테이블을 삭제합니다.

테이블 삭제 [사용되지 않음]

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

테이블을 삭제합니다.

병합 엔터티(V2)

테이블의 엔터티와 데이터를 병합하는 작업입니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

ETag
If-Match True string

동시성에 대해 일치시킬 Etag입니다. * 모든 값과 일치합니다.

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

병합 엔터티 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 병합 엔터티(V2) 를 사용하세요.

테이블의 엔터티와 데이터를 병합하는 작업입니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

ETag
If-Match True string

동시성에 대해 일치시킬 Etag입니다. * 모든 값과 일치합니다.

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

엔터티 가져오기(V2)

이 작업은 테이블의 엔터티를 쿼리합니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

필터 쿼리
$filter string

반환할 엔터티에 대한 OData 필터 쿼리입니다. 예: 열 eq 'Value' 및 Column2 ne 2. 문자열 값을 따옴표로 래핑하지 않는 등 잘못된 OData 쿼리는 501을 반환합니다.

쿼리 선택
$select string

OData는 반환할 열에 대한 쿼리를 선택합니다. 예: Column, PartitionKey

반환

엔터티 응답 개체

엔터티 결과 가져오기
getEntitiesResponse

엔터티 가져오기(V2)

이 작업은 파티션 및 행 키를 기반으로 테이블의 엔터티를 가져옵니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

쿼리 선택
$select string

OData는 반환할 열에 대한 쿼리를 선택합니다. 예: Column, PartitionKey

반환

엔터티

엔터티
getEntityResponse

엔터티 가져오기 [사용되지 않음]

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

이 작업은 테이블의 엔터티를 쿼리합니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

필터 쿼리
$filter string

반환할 엔터티에 대한 OData 필터 쿼리입니다. 예: 열 eq 'Value' 및 Column2 ne 2. 문자열 값을 따옴표로 래핑하지 않는 등 잘못된 OData 쿼리는 501을 반환합니다.

쿼리 선택
$select string

OData는 반환할 열에 대한 쿼리를 선택합니다. 예: Column, PartitionKey

반환

엔터티 응답 개체

엔터티 결과 가져오기
getEntitiesResponse

엔터티 가져오기 [사용되지 않음]

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

이 작업은 파티션 및 행 키를 기반으로 테이블의 엔터티를 가져옵니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

쿼리 선택
$select string

OData는 반환할 열에 대한 쿼리를 선택합니다. 예: Column, PartitionKey

반환

엔터티

엔터티
getEntityResponse

엔터티 바꾸기(V2)

테이블의 엔터티를 바꾸는 작업입니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

ETag
If-Match True string

동시성을 위해 일치시킬 ETag입니다. * 모든 값과 일치합니다.

클라이언트 요청 ID
x-ms-client-request-id string

서버 응답에 에코되는 작업에 대한 클라이언트 제공 식별자입니다.

엔터티 바꾸기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 엔터티 바꾸기(V2) 를 사용하세요.

테이블의 엔터티를 바꾸는 작업입니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

ETag
If-Match True string

동시성을 위해 일치시킬 ETag입니다. * 모든 값과 일치합니다.

클라이언트 요청 ID
x-ms-client-request-id string

서버 응답에 에코되는 작업에 대한 클라이언트 제공 식별자입니다.

엔터티 삭제(V2)

엔터티를 삭제하는 작업입니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

클라이언트 요청 ID
x-ms-client-request-id string

서버 응답에 에코되는 작업에 대한 클라이언트 제공 식별자입니다.

ETag
If-Match string

동시성에 대해 일치시킬 Etag입니다. * 모든 값과 일치합니다.

엔터티 삭제 [사용되지 않음]

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

엔터티를 삭제하는 작업입니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

클라이언트 요청 ID
x-ms-client-request-id string

서버 응답에 에코되는 작업에 대한 클라이언트 제공 식별자입니다.

ETag
If-Match string

동시성에 대해 일치시킬 Etag입니다. * 모든 값과 일치합니다.

엔터티 삽입(V2)

테이블에 엔터티를 추가하는 작업입니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

클라이언트 요청 ID
x-ms-client-request-id string

서버 응답에 에코되는 작업에 대한 클라이언트 제공 식별자입니다.

반환

단일 엔터티에 대한 데이터

엔터티 삽입 [사용되지 않음]

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

테이블에 엔터티를 추가하는 작업입니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

클라이언트 요청 ID
x-ms-client-request-id string

서버 응답에 에코되는 작업에 대한 클라이언트 제공 식별자입니다.

반환

단일 엔터티에 대한 데이터

엔터티 삽입 또는 바꾸기(V2)

테이블의 엔터티를 대체하는 작업으로 필요한 경우 새 엔터티를 만듭니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

엔터티 삽입 또는 바꾸기 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 엔터티 삽입 또는 바꾸기(V2) 를 사용하세요.

테이블의 엔터티를 대체하는 작업으로 필요한 경우 새 엔터티를 만듭니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

엔터티 삽입 또는 병합(V2)

테이블에 있는 엔터티와 데이터를 병합하여 필요한 경우 새 엔터티를 만드는 작업입니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

클라이언트 요청 ID
x-ms-client-request-id string

서버 응답에 에코되는 작업에 대한 클라이언트 제공 식별자입니다.

엔터티 삽입 또는 병합 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 엔터티 삽입 또는 병합(V2) 을 사용하세요.

테이블에 있는 엔터티와 데이터를 병합하여 필요한 경우 새 엔터티를 만드는 작업입니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

파티션 키
PartitionKey True string

이 엔터티를 포함하는 파티션 ID

행 키
RowKey True string

이 엔터티를 포함하는 행 ID

클라이언트 요청 ID
x-ms-client-request-id string

서버 응답에 에코되는 작업에 대한 클라이언트 제공 식별자입니다.

테이블 가져오기(V2)

이 작업은 테이블의 메타데이터를 가져옵니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

반환

테이블의 메타데이터

테이블 메타데이터
getTableResponse

테이블 가져오기 [사용되지 않음]

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

이 작업은 테이블의 메타데이터를 가져옵니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

반환

테이블의 메타데이터

테이블 메타데이터
getTableResponse

테이블 나열(V2)

스토리지 계정의 모든 테이블을 나열합니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

반환

테이블 쿼리 응답 개체

테이블 나열 [사용되지 않음]

이 작업은 더 이상 사용되지 않습니다. 대신 목록 테이블(V2) 을 사용하세요.

이 작업은 계정의 테이블을 나열합니다.

매개 변수

Name 필수 형식 Description
클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

반환

테이블 쿼리 응답 개체

테이블 만들기(V2)

이 작업은 스토리지 계정에 테이블을 추가합니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
TableName True string

새 테이블 지정

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

반환

테이블의 메타데이터

테이블 메타데이터
getTableResponse

테이블 만들기 [사용되지 않음]

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

이 작업은 스토리지 계정에 테이블을 추가합니다.

매개 변수

Name 필수 형식 Description
Table
TableName True string

새 테이블 지정

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

반환

테이블의 메타데이터

테이블 메타데이터
getTableResponse

테이블 삭제(V2)

테이블을 삭제합니다.

매개 변수

Name 필수 형식 Description
스토리지 계정 이름 또는 테이블 엔드포인트
storageAccountName True string

Azure Storage 계정 이름 또는 테이블 엔드포인트.

Table
tableName True string

테이블을 지정합니다.

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

테이블 삭제 [사용되지 않음]

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

테이블을 삭제합니다.

매개 변수

Name 필수 형식 Description
Table
tableName True string

테이블을 지정합니다.

클라이언트 요청 ID
x-ms-client-request-id string

요청을 추적하기 위한 고유 식별자입니다.

정의

getTablesResponse

테이블 쿼리 응답 개체

Name 경로 형식 Description
계정 메타데이터 위치
odata.metadata string

계정 메타데이터에 대한 URL

테이블 목록
value array of object

테이블 목록

테이블 위치
value.odata.id string

테이블 데이터에 대한 URL

테이블 이름
value.TableName string

테이블 이름

getTableResponse

테이블의 메타데이터

Name 경로 형식 Description
테이블 위치
odata.id string

테이블 데이터에 대한 URL

테이블 이름
TableName string

테이블 이름

Item

엔터티

Name 경로 형식 Description
파티션 키
PartitionKey string

파티션 키

행 키
RowKey string

행 키

엔터티 데이터
additionalProperties string

엔터티에 대한 고유 열

getEntitiesResponse

엔터티 응답 개체

Name 경로 형식 Description
테이블 메타데이터 위치
odata.metadata string

테이블 메타데이터 위치

엔터티 목록
value array of Item

엔터티 목록

getEntityResponse

엔터티

Name 경로 형식 Description
테이블 메타데이터 위치
odata.metadata string

테이블 메타데이터 위치

파티션 키
PartitionKey string

파티션 키

행 키
RowKey string

행 키

엔터티 데이터
additionalProperties string

엔터티에 대한 고유 열

InsertEntityResponse

단일 엔터티에 대한 데이터

Name 경로 형식 Description
엔터티 메타데이터 위치
odata.metadata string

엔터티 메타데이터 위치

파티션 키
PartitionKey string

파티션 키

행 키
RowKey string

행 키

엔터티 데이터
additionalProperties string

엔터티에 대한 고유 열