Data Set Mappings - Get

참조

Service:: Data Share

API Version:: 2021-08-01

shareSubscription에서 DataSetMapping을 가져옵니다.
shareSubscription에서 DataSetMapping 가져오기

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/dataSetMappings/{dataSetMappingName}?api-version=2021-08-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
accountName	path	True	string	공유 계정의 이름입니다.
dataSetMappingName	path	True	string	dataSetMapping의 이름입니다.
resourceGroupName	path	True	string	리소스 그룹 이름입니다.
shareSubscriptionName	path	True	string	shareSubscription의 이름입니다.
subscriptionId	path	True	string	구독 식별자
api-version	query	True	string	사용할 api 버전입니다.

응답

Name	형식	Description
200 OK	DataSetMapping: ADLSGen2FileDataSetMapping ADLSGen2FileSystemDataSetMapping ADLSGen2FolderDataSetMapping BlobContainerDataSetMapping BlobDataSetMapping BlobFolderDataSetMapping KustoClusterDataSetMapping KustoDatabaseDataSetMapping KustoTableDataSetMapping SqlDBTableDataSetMapping SqlDWTableDataSetMapping SynapseWorkspaceSqlPoolTableDataSetMapping	Success
Other Status Codes	DataShareError	Microsoft.DataShare 리소스 공급자로부터 받은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	사용자 계정 가장

예제

DataSetMappings_Get

GET https://management.azure.com/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1/shareSubscriptions/ShareSubscription1/dataSetMappings/DatasetMapping1?api-version=2021-08-01

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.DataShare;
using Azure.ResourceManager.DataShare.Models;

// Generated from example definition: specification/datashare/resource-manager/Microsoft.DataShare/stable/2021-08-01/examples/DataSetMappings_Get.json
// this example is just showing the usage of "DataSetMappings_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ShareSubscriptionResource created on azure
// for more information of creating ShareSubscriptionResource, please refer to the document of ShareSubscriptionResource
string subscriptionId = "433a8dfd-e5d5-4e77-ad86-90acdc75eb1a";
string resourceGroupName = "SampleResourceGroup";
string accountName = "Account1";
string shareSubscriptionName = "ShareSubscription1";
ResourceIdentifier shareSubscriptionResourceId = ShareSubscriptionResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, shareSubscriptionName);
ShareSubscriptionResource shareSubscription = client.GetShareSubscriptionResource(shareSubscriptionResourceId);

// get the collection of this ShareDataSetMappingResource
ShareDataSetMappingCollection collection = shareSubscription.GetShareDataSetMappings();

// invoke the operation
string dataSetMappingName = "DatasetMapping1";
NullableResponse<ShareDataSetMappingResource> response = await collection.GetIfExistsAsync(dataSetMappingName);
ShareDataSetMappingResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine($"Succeeded with null as result");
}
else
{
    // the variable result is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    ShareDataSetMappingData resourceData = result.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-tenant-reads: 14999
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd

Response Body

{
  "kind": "Blob",
  "properties": {
    "dataSetId": "a08f184b-0567-4b11-ba22-a1199336d226",
    "storageAccountName": "storage2",
    "filePath": "file21",
    "containerName": "C1",
    "subscriptionId": "433a8dfd-e5d5-4e77-ad86-90acdc75eb1a",
    "resourceGroup": "SampleResourceGroup"
  },
  "id": "/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.DataShare/accounts/Account1/shareSubscriptions/ShareSubscription1/dataSetMappings/DatasetMapping1",
  "name": "DatasetMapping1",
  "type": "Microsoft.DataShare/accounts/shareSubscriptions/dataSetMappings"
}

정의

Name	Description
ADLSGen2FileDataSetMapping	ADLS Gen2 파일 데이터 세트 매핑입니다.
ADLSGen2FileSystemDataSetMapping	ADLS Gen2 파일 시스템 데이터 세트 매핑.
ADLSGen2FolderDataSetMapping	ADLS Gen2 폴더 데이터 세트 매핑.
BlobContainerDataSetMapping	Blob 컨테이너 데이터 세트 매핑입니다.
BlobDataSetMapping	Blob 데이터 세트 매핑입니다.
BlobFolderDataSetMapping	Blob 폴더 데이터 집합 매핑입니다.
createdByType	리소스를 만든 ID 유형입니다.
dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
DataShareError	데이터 공유 오류 모델입니다.
DataShareErrorInfo	데이터 공유 오류 본문 모델입니다.
KustoClusterDataSetMapping	Kusto 클러스터 데이터 세트 매핑
KustoDatabaseDataSetMapping	Kusto 데이터베이스 데이터 세트 매핑
KustoTableDataSetMapping	Kusto 데이터베이스 데이터 세트 매핑
lastModifiedByType	리소스를 마지막으로 수정한 ID 유형입니다.
outputType	출력 파일 형식
provisioningState	계정의 프로비전 상태
SqlDBTableDataSetMapping	SQL DB 테이블 데이터 세트 매핑.
SqlDWTableDataSetMapping	SQL DW 테이블 데이터 세트 매핑.
SynapseWorkspaceSqlPoolTableDataSetMapping	Synapse 작업 영역 Sql 풀 테이블 데이터 세트 매핑
SystemData	리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

ADLSGen2FileDataSetMapping

ADLS Gen2 파일 데이터 세트 매핑입니다.

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: AdlsGen2File	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.filePath	string	파일 시스템 내의 파일 경로입니다.
properties.fileSystem	string	파일이 속한 파일 시스템입니다.
properties.outputType	outputType	출력 파일 형식
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
properties.resourceGroup	string	스토리지 계정의 리소스 그룹입니다.
properties.storageAccountName	string	원본 데이터 집합의 스토리지 계정 이름입니다.
properties.subscriptionId	string	스토리지 계정의 구독 ID입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

ADLSGen2FileSystemDataSetMapping

ADLS Gen2 파일 시스템 데이터 세트 매핑.

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: AdlsGen2FileSystem	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.fileSystem	string	파일 시스템 이름입니다.
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
properties.resourceGroup	string	스토리지 계정의 리소스 그룹입니다.
properties.storageAccountName	string	원본 데이터 집합의 스토리지 계정 이름입니다.
properties.subscriptionId	string	스토리지 계정의 구독 ID입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

ADLSGen2FolderDataSetMapping

ADLS Gen2 폴더 데이터 세트 매핑.

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: AdlsGen2Folder	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.fileSystem	string	폴더가 속한 파일 시스템입니다.
properties.folderPath	string	파일 시스템 내의 폴더 경로입니다.
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
properties.resourceGroup	string	스토리지 계정의 리소스 그룹입니다.
properties.storageAccountName	string	원본 데이터 집합의 스토리지 계정 이름입니다.
properties.subscriptionId	string	스토리지 계정의 구독 ID입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

BlobContainerDataSetMapping

Blob 컨테이너 데이터 세트 매핑입니다.

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: Container	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.containerName	string	BLOB 컨테이너 이름입니다.
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
properties.resourceGroup	string	스토리지 계정의 리소스 그룹입니다.
properties.storageAccountName	string	원본 데이터 집합의 스토리지 계정 이름입니다.
properties.subscriptionId	string	스토리지 계정의 구독 ID입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

BlobDataSetMapping

Blob 데이터 세트 매핑입니다.

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: Blob	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.containerName	string	파일 경로가 있는 컨테이너입니다.
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.filePath	string	원본 데이터 집합 내의 파일 경로
properties.outputType	outputType	파일 출력 형식
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
properties.resourceGroup	string	스토리지 계정의 리소스 그룹입니다.
properties.storageAccountName	string	원본 데이터 집합의 스토리지 계정 이름입니다.
properties.subscriptionId	string	스토리지 계정의 구독 ID입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

BlobFolderDataSetMapping

Blob 폴더 데이터 집합 매핑입니다.

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: BlobFolder	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.containerName	string	파일 경로가 있는 컨테이너입니다.
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.prefix	string	Blob 폴더의 접두사
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
properties.resourceGroup	string	스토리지 계정의 리소스 그룹입니다.
properties.storageAccountName	string	원본 데이터 집합의 스토리지 계정 이름입니다.
properties.subscriptionId	string	스토리지 계정의 구독 ID입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

createdByType

리소스를 만든 ID 유형입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

dataSetMappingStatus

데이터 세트 매핑의 상태 가져옵니다.

Name	형식	Description
Broken	string
Ok	string

DataShareError

데이터 공유 오류 모델입니다.

Name	형식	Description
error	DataShareErrorInfo	데이터 공유 오류 본문

DataShareErrorInfo

데이터 공유 오류 본문 모델입니다.

Name	형식	Description
code	string	오류 코드
details	DataShareErrorInfo[]	오류 모델의 중첩된 세부 정보
message	string	오류 메시지
target	string	오류의 대상

KustoClusterDataSetMapping

Kusto 클러스터 데이터 세트 매핑

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: KustoCluster	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.kustoClusterResourceId	string	싱크 kusto 클러스터의 리소스 ID입니다.
properties.location	string	싱크 kusto 클러스터의 위치입니다.
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

KustoDatabaseDataSetMapping

Kusto 데이터베이스 데이터 세트 매핑

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: KustoDatabase	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.kustoClusterResourceId	string	싱크 kusto 클러스터의 리소스 ID입니다.
properties.location	string	싱크 kusto 클러스터의 위치입니다.
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

KustoTableDataSetMapping

Kusto 데이터베이스 데이터 세트 매핑

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: KustoTable	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.kustoClusterResourceId	string	싱크 kusto 클러스터의 리소스 ID입니다.
properties.location	string	싱크 kusto 클러스터의 위치입니다.
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

lastModifiedByType

리소스를 마지막으로 수정한 ID 유형입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

outputType

출력 파일 형식

Name	형식	Description
Csv	string
Parquet	string

provisioningState

계정의 프로비전 상태

Name	형식	Description
Creating	string
Deleting	string
Failed	string
Moving	string
Succeeded	string

SqlDBTableDataSetMapping

SQL DB 테이블 데이터 세트 매핑.

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: SqlDBTable	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.databaseName	string	싱크 데이터 집합의 DatabaseName 이름
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
properties.schemaName	string	테이블의 스키마입니다. 기본값은 dbo입니다.
properties.sqlServerResourceId	string	SQL Server의 리소스 ID
properties.tableName	string	SQL DB 테이블 이름입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

SqlDWTableDataSetMapping

SQL DW 테이블 데이터 세트 매핑.

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: SqlDWTable	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.dataWarehouseName	string	원본 데이터 집합의 DataWarehouse 이름
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
properties.schemaName	string	테이블의 스키마입니다. 기본값은 dbo입니다.
properties.sqlServerResourceId	string	SQL Server의 리소스 ID
properties.tableName	string	SQL DW 테이블 이름입니다.
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

SynapseWorkspaceSqlPoolTableDataSetMapping

Synapse 작업 영역 Sql 풀 테이블 데이터 세트 매핑

Name	형식	Description
id	string	Azure 리소스의 리소스 ID
kind	string: SynapseWorkspaceSqlPoolTable	데이터 세트 매핑의 종류입니다.
name	string	Azure 리소스의 이름
properties.dataSetId	string	원본 데이터 집합의 ID입니다.
properties.dataSetMappingStatus	dataSetMappingStatus	데이터 세트 매핑의 상태 가져옵니다.
properties.provisioningState	provisioningState	데이터 세트 매핑의 프로비전 상태입니다.
properties.synapseWorkspaceSqlPoolTableResourceId	string	Synapse 작업 영역 SQL 풀 테이블의 리소스 ID
systemData	SystemData	Azure 리소스의 시스템 데이터입니다.
type	string	Azure 리소스 유형

SystemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string	UTC(리소스 만들기)의 타임스탬프입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID 유형입니다.
lastModifiedAt	string	리소스를 마지막으로 수정한 ID 유형입니다.
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	lastModifiedByType	리소스를 마지막으로 수정한 ID 유형입니다.