Data Set Mappings - Get

Odwołanie

Service:: Data Share

API Version:: 2021-08-01

Pobierz element DataSetMapping w podskrypcji udziału.
Pobieranie elementu DataSetMapping w subskrypcji udziału

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string	Nazwa konta udziału.
dataSetMappingName	path	True	string	Nazwa elementu dataSetMapping.
resourceGroupName	path	True	string	Nazwa grupy zasobów.
shareSubscriptionName	path	True	string	Nazwa subskrypcji shareSubscription.
subscriptionId	path	True	string	Identyfikator subskrypcji
api-version	query	True	string	Wersja interfejsu API do użycia.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DataSetMapping: ADLSGen2FileDataSetMapping ADLSGen2FileSystemDataSetMapping ADLSGen2FolderDataSetMapping BlobContainerDataSetMapping BlobDataSetMapping BlobFolderDataSetMapping KustoClusterDataSetMapping KustoDatabaseDataSetMapping KustoTableDataSetMapping SqlDBTableDataSetMapping SqlDWTableDataSetMapping SynapseWorkspaceSqlPoolTableDataSetMapping	Powodzenie
Other Status Codes	DataShareError	Odebrano odpowiedź o błędzie od dostawcy zasobów Microsoft.DataShare.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

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

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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"
}

Definicje

Nazwa	Opis
ADLSGen2FileDataSetMapping	Mapowanie zestawu danych plików usługi ADLS Gen2.
ADLSGen2FileSystemDataSetMapping	Mapowanie zestawu danych systemu plików usługi ADLS Gen2.
ADLSGen2FolderDataSetMapping	Mapowanie zestawu danych folderów usługi ADLS Gen2.
BlobContainerDataSetMapping	Mapowanie zestawu danych kontenera obiektów blob.
BlobDataSetMapping	Mapowanie zestawu danych obiektów blob.
BlobFolderDataSetMapping	Mapowanie zestawu danych folderów obiektów blob.
createdByType	Typ tożsamości, która utworzyła zasób.
dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
DataShareError	Model błędu udziału danych.
DataShareErrorInfo	Model treści błędu udziału danych.
KustoClusterDataSetMapping	Mapowanie zestawu danych klastra Kusto
KustoDatabaseDataSetMapping	Mapowanie zestawu danych bazy danych Kusto
KustoTableDataSetMapping	Mapowanie zestawu danych bazy danych Kusto
lastModifiedByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.
outputType	Typ pliku wyjściowego
provisioningState	Stan aprowizacji konta
SqlDBTableDataSetMapping	Mapowanie zestawu danych tabel usługi SQL DB.
SqlDWTableDataSetMapping	Mapowanie zestawu danych tabeli USŁUGI SQL DW.
SynapseWorkspaceSqlPoolTableDataSetMapping	Mapowanie zestawu danych tabeli puli SQL obszaru roboczego usługi Synapse
SystemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

ADLSGen2FileDataSetMapping

Mapowanie zestawu danych plików usługi ADLS Gen2.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: AdlsGen2File	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.filePath	string	Ścieżka pliku w systemie plików.
properties.fileSystem	string	System plików, do którego należy plik.
properties.outputType	outputType	Typ pliku wyjściowego
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
properties.resourceGroup	string	Grupa zasobów konta magazynu.
properties.storageAccountName	string	Nazwa konta magazynu źródłowego zestawu danych.
properties.subscriptionId	string	Identyfikator subskrypcji konta magazynu.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

ADLSGen2FileSystemDataSetMapping

Mapowanie zestawu danych systemu plików usługi ADLS Gen2.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: AdlsGen2FileSystem	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.fileSystem	string	Nazwa systemu plików.
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
properties.resourceGroup	string	Grupa zasobów konta magazynu.
properties.storageAccountName	string	Nazwa konta magazynu źródłowego zestawu danych.
properties.subscriptionId	string	Identyfikator subskrypcji konta magazynu.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

ADLSGen2FolderDataSetMapping

Mapowanie zestawu danych folderów usługi ADLS Gen2.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: AdlsGen2Folder	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.fileSystem	string	System plików, do którego należy folder.
properties.folderPath	string	Ścieżka folderu w systemie plików.
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
properties.resourceGroup	string	Grupa zasobów konta magazynu.
properties.storageAccountName	string	Nazwa konta magazynu źródłowego zestawu danych.
properties.subscriptionId	string	Identyfikator subskrypcji konta magazynu.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

BlobContainerDataSetMapping

Mapowanie zestawu danych kontenera obiektów blob.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: Container	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.containerName	string	Nazwa kontenera obiektów blOB.
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
properties.resourceGroup	string	Grupa zasobów konta magazynu.
properties.storageAccountName	string	Nazwa konta magazynu źródłowego zestawu danych.
properties.subscriptionId	string	Identyfikator subskrypcji konta magazynu.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

BlobDataSetMapping

Mapowanie zestawu danych obiektów blob.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: Blob	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.containerName	string	Kontener, który ma ścieżkę pliku.
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.filePath	string	Ścieżka pliku w źródłowym zestawie danych
properties.outputType	outputType	Typ danych wyjściowych pliku
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
properties.resourceGroup	string	Grupa zasobów konta magazynu.
properties.storageAccountName	string	Nazwa konta magazynu źródłowego zestawu danych.
properties.subscriptionId	string	Identyfikator subskrypcji konta magazynu.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

BlobFolderDataSetMapping

Mapowanie zestawu danych folderów obiektów blob.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: BlobFolder	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.containerName	string	Kontener, który ma ścieżkę pliku.
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.prefix	string	Prefiks folderu obiektów blob
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
properties.resourceGroup	string	Grupa zasobów konta magazynu.
properties.storageAccountName	string	Nazwa konta magazynu źródłowego zestawu danych.
properties.subscriptionId	string	Identyfikator subskrypcji konta magazynu.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

dataSetMappingStatus

Pobiera stan mapowania zestawu danych.

Nazwa	Typ	Opis
Broken	string
Ok	string

DataShareError

Model błędu udziału danych.

Nazwa	Typ	Opis
error	DataShareErrorInfo	Treść błędu udziału danych

DataShareErrorInfo

Model treści błędu udziału danych.

Nazwa	Typ	Opis
code	string	Kod błędu
details	DataShareErrorInfo[]	Zagnieżdżone szczegóły modelu błędu
message	string	Komunikat o błędzie
target	string	Element docelowy błędu

KustoClusterDataSetMapping

Mapowanie zestawu danych klastra Kusto

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: KustoCluster	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.kustoClusterResourceId	string	Identyfikator zasobu klastra kusto ujścia.
properties.location	string	Lokalizacja klastra kusto ujścia.
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

KustoDatabaseDataSetMapping

Mapowanie zestawu danych bazy danych Kusto

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: KustoDatabase	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.kustoClusterResourceId	string	Identyfikator zasobu klastra kusto ujścia.
properties.location	string	Lokalizacja klastra kusto ujścia.
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

KustoTableDataSetMapping

Mapowanie zestawu danych bazy danych Kusto

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: KustoTable	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.kustoClusterResourceId	string	Identyfikator zasobu klastra kusto ujścia.
properties.location	string	Lokalizacja klastra kusto ujścia.
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

lastModifiedByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

outputType

Typ pliku wyjściowego

Nazwa	Typ	Opis
Csv	string
Parquet	string

provisioningState

Stan aprowizacji konta

Nazwa	Typ	Opis
Creating	string
Deleting	string
Failed	string
Moving	string
Succeeded	string

SqlDBTableDataSetMapping

Mapowanie zestawu danych tabel usługi SQL DB.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: SqlDBTable	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.databaseName	string	DatabaseName nazwa zestawu danych ujścia
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
properties.schemaName	string	Schemat tabeli. Wartość domyślna to dbo.
properties.sqlServerResourceId	string	Identyfikator zasobu programu SQL Server
properties.tableName	string	Nazwa tabeli bazy danych SQL.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

SqlDWTableDataSetMapping

Mapowanie zestawu danych tabeli USŁUGI SQL DW.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: SqlDWTable	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.dataWarehouseName	string	DataWarehouse nazwa źródłowego zestawu danych
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
properties.schemaName	string	Schemat tabeli. Wartość domyślna to dbo.
properties.sqlServerResourceId	string	Identyfikator zasobu programu SQL Server
properties.tableName	string	Nazwa tabeli usługi SQL DW.
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

SynapseWorkspaceSqlPoolTableDataSetMapping

Mapowanie zestawu danych tabeli puli SQL obszaru roboczego usługi Synapse

Nazwa	Typ	Opis
id	string	Identyfikator zasobu platformy Azure
kind	string: SynapseWorkspaceSqlPoolTable	Rodzaj mapowania zestawu danych.
name	string	Nazwa zasobu platformy Azure
properties.dataSetId	string	Identyfikator źródłowego zestawu danych.
properties.dataSetMappingStatus	dataSetMappingStatus	Pobiera stan mapowania zestawu danych.
properties.provisioningState	provisioningState	Stan aprowizacji mapowania zestawu danych.
properties.synapseWorkspaceSqlPoolTableResourceId	string	Identyfikator zasobu tabeli puli SQL obszaru roboczego usługi Synapse
systemData	SystemData	Dane systemowe zasobu platformy Azure.
type	string	Typ zasobu platformy Azure

SystemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Typ tożsamości, która ostatnio zmodyfikowała zasób.
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	lastModifiedByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.