Sync Groups - List Hub Schemas

서비스:: SQL Database

API 버전:: 2023-08-01

허브 데이터베이스 스키마의 컬렉션을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/syncGroups/{syncGroupName}/hubSchemas?api-version=2023-08-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
databaseName	path	True	string	동기화 그룹이 호스트되는 데이터베이스의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
syncGroupName	path	True	string	동기화 그룹의 이름입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	SyncFullSchemaPropertiesListResult	동기화 그룹 허브 데이터베이스 스키마를 성공적으로 가져옵니다.
Other Status Codes	ErrorResponse	오류 응답: *** 400 InvalidSyncGroupCreateOrUpdateRequest - 동기화 그룹 만들기 또는 업데이트 요청 본문이 비어 있습니다. 400 InvalidSyncMemberCreateOrUpdateRequest - 동기화 멤버 만들기 또는 업데이트 요청 본문이 비어 있습니다. 400 InvalidSyncAgentCreateOrUpdateRequest - 동기화 에이전트 요청 본문 만들기 또는 업데이트가 비어 있습니다. 400 InvalidDatabaseResourceId - 잘못된 데이터베이스 리소스 식별자입니다. 400 InvalidSyncGroupName - 동기화 그룹 이름이 잘못되었습니다. 이 필드에는 문자, 숫자, 대시 및 밑줄이 포함될 수 있습니다. 400 InvalidSyncMemberName - 동기화 멤버 이름이 잘못되었습니다. 이 필드에는 문자, 숫자, 대시 및 밑줄이 포함될 수 있습니다. 400 MissingSyncMemberName - 동기화 멤버 이름이 없습니다. 400 InvalidSyncGroupInterval - 동기화 간격은 5초보다 크거나 같아야 합니다. 400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다. 400 InvalidSyncAgentResourceId - 잘못된 동기화 에이전트 리소스 식별자입니다. 400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다. 400 MismatchingServerNameWithUrl - 제공된 서버 이름이 URL의 이름과 일치하지 않습니다. 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다. 400 MissingServerName - 서버 이름이 없습니다. 400 MissingDatabaseName - 데이터베이스 이름이 없습니다. 400 MissingSyncGroupName - 동기화 그룹 이름이 없습니다. 400 MissingConflictResolutionPolicy - 충돌 해결 정책이 없습니다. 400 MissingSyncAgentName - 동기화 에이전트 이름이 없습니다. 400 SyncOperation_GenericFailure - 데이터 동기화 작업을 수행하지 못했습니다. 400 InvalidSyncGroup - 동기화 그룹이 잘못되었습니다. 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다. 400 CannotCreateSyncGroupDueToQuotaExceeded - 할당량 초과로 인해 동기화 그룹을 만들 수 없습니다. 400 SyncOperation_DuplicateSyncGroupDrop - 동기화 그룹이 이미 삭제되고 있습니다. 400 SyncOperation_WrongSyncDatabase - 지정된 동기화 데이터베이스가 기존 데이터베이스와 일치하지 않습니다. 400 SyncOperation_UpdateSyncGroupWhenDropping - 현재 삭제 중이므로 동기화 그룹을 업데이트할 수 없습니다. 400 SyncOperation_DwInSyncGroup - 데이터 동기화에서 Datawarehouse 버전을 사용할 수 없습니다. 400 SyncOperation_MasterDbInSyncGroup - 데이터 동기화에서 논리 마스터를 사용할 수 없습니다. 400 SyncOperation_UnsupportedDataTypeColumnInSchema - 열의 데이터 형식이 지원되지 않으므로 스키마에 열을 추가할 수 없습니다. 400 SyncOperation_InvalidCredential - 데이터베이스 자격 증명이 잘못되었습니다. 400 InvalidSyncMetadataDatabase - 동기화 메타데이터 데이터베이스가 잘못되었습니다. 400 SyncOperation_InvalidSyncInterval - 동기화 간격이 잘못되었으므로 동기화 그룹을 만들거나 업데이트할 수 없습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 DatabaseDoesNotExist - 사용자가 이 서버 인스턴스에 없는 데이터베이스 이름을 지정했습니다. 404 SyncOperation_HubServerNotFound - 허브 논리 서버가 없습니다. 404 SyncOperation_InvalidHubDatabase - 허브 데이터베이스가 잘못되었습니다. 409 SyncOperation_DuplicateSyncGroupName - 이름이 같은 동기화 그룹이 이미 있으므로 동기화 그룹을 만들 수 없습니다.

Name

형식

Description

200 OK

SyncFullSchemaPropertiesListResult

동기화 그룹 허브 데이터베이스 스키마를 성공적으로 가져옵니다.

Other Status Codes

ErrorResponse

오류 응답: ***

400 InvalidSyncGroupCreateOrUpdateRequest - 동기화 그룹 만들기 또는 업데이트 요청 본문이 비어 있습니다.
400 InvalidSyncMemberCreateOrUpdateRequest - 동기화 멤버 만들기 또는 업데이트 요청 본문이 비어 있습니다.
400 InvalidSyncAgentCreateOrUpdateRequest - 동기화 에이전트 요청 본문 만들기 또는 업데이트가 비어 있습니다.
400 InvalidDatabaseResourceId - 잘못된 데이터베이스 리소스 식별자입니다.
400 InvalidSyncGroupName - 동기화 그룹 이름이 잘못되었습니다. 이 필드에는 문자, 숫자, 대시 및 밑줄이 포함될 수 있습니다.
400 InvalidSyncMemberName - 동기화 멤버 이름이 잘못되었습니다. 이 필드에는 문자, 숫자, 대시 및 밑줄이 포함될 수 있습니다.
400 MissingSyncMemberName - 동기화 멤버 이름이 없습니다.
400 InvalidSyncGroupInterval - 동기화 간격은 5초보다 크거나 같아야 합니다.
400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다.
400 InvalidSyncAgentResourceId - 잘못된 동기화 에이전트 리소스 식별자입니다.
400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다.
400 MismatchingServerNameWithUrl - 제공된 서버 이름이 URL의 이름과 일치하지 않습니다.
400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다.
400 MissingServerName - 서버 이름이 없습니다.
400 MissingDatabaseName - 데이터베이스 이름이 없습니다.
400 MissingSyncGroupName - 동기화 그룹 이름이 없습니다.
400 MissingConflictResolutionPolicy - 충돌 해결 정책이 없습니다.
400 MissingSyncAgentName - 동기화 에이전트 이름이 없습니다.
400 SyncOperation_GenericFailure - 데이터 동기화 작업을 수행하지 못했습니다.
400 InvalidSyncGroup - 동기화 그룹이 잘못되었습니다.
400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다.
400 CannotCreateSyncGroupDueToQuotaExceeded - 할당량 초과로 인해 동기화 그룹을 만들 수 없습니다.
400 SyncOperation_DuplicateSyncGroupDrop - 동기화 그룹이 이미 삭제되고 있습니다.
400 SyncOperation_WrongSyncDatabase - 지정된 동기화 데이터베이스가 기존 데이터베이스와 일치하지 않습니다.
400 SyncOperation_UpdateSyncGroupWhenDropping - 현재 삭제 중이므로 동기화 그룹을 업데이트할 수 없습니다.
400 SyncOperation_DwInSyncGroup - 데이터 동기화에서 Datawarehouse 버전을 사용할 수 없습니다.
400 SyncOperation_MasterDbInSyncGroup - 데이터 동기화에서 논리 마스터를 사용할 수 없습니다.
400 SyncOperation_UnsupportedDataTypeColumnInSchema - 열의 데이터 형식이 지원되지 않으므로 스키마에 열을 추가할 수 없습니다.
400 SyncOperation_InvalidCredential - 데이터베이스 자격 증명이 잘못되었습니다.
400 InvalidSyncMetadataDatabase - 동기화 메타데이터 데이터베이스가 잘못되었습니다.
400 SyncOperation_InvalidSyncInterval - 동기화 간격이 잘못되었으므로 동기화 그룹을 만들거나 업데이트할 수 없습니다.
404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 DatabaseDoesNotExist - 사용자가 이 서버 인스턴스에 없는 데이터베이스 이름을 지정했습니다.
404 SyncOperation_HubServerNotFound - 허브 논리 서버가 없습니다.
404 SyncOperation_InvalidHubDatabase - 허브 데이터베이스가 잘못되었습니다.
409 SyncOperation_DuplicateSyncGroupName - 이름이 같은 동기화 그룹이 이미 있으므로 동기화 그룹을 만들 수 없습니다.

예제

Get a hub database schema.

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/syncgroupcrud-65440/providers/Microsoft.Sql/servers/syncgroupcrud-8475/databases/syncgroupcrud-4328/syncGroups/syncgroupcrud-3187/hubSchemas?api-version=2023-08-01

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

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/SyncGroupGetHubSchema.json
// this example is just showing the usage of "SyncGroups_ListHubSchemas" 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 SyncGroupResource created on azure
// for more information of creating SyncGroupResource, please refer to the document of SyncGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "syncgroupcrud-65440";
string serverName = "syncgroupcrud-8475";
string databaseName = "syncgroupcrud-4328";
string syncGroupName = "syncgroupcrud-3187";
ResourceIdentifier syncGroupResourceId = SyncGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName, syncGroupName);
SyncGroupResource syncGroup = client.GetSyncGroupResource(syncGroupResourceId);

// invoke the operation and iterate over the result
await foreach (SyncFullSchemaProperties item in syncGroup.GetHubSchemasAsync())
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine("Succeeded");

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

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "tables": [
        {
          "columns": [
            {
              "dataSize": "4",
              "dataType": "int",
              "hasError": false,
              "isPrimaryKey": false,
              "name": "intField",
              "quotedName": "[intField]"
            },
            {
              "dataSize": "100",
              "dataType": "nvarchar",
              "hasError": false,
              "isPrimaryKey": false,
              "name": "charField",
              "quotedName": "[charField]"
            }
          ],
          "errorId": "Schema_TableHasNoPrimaryKey",
          "hasError": true,
          "name": "dbo.myTable",
          "quotedName": "[dbo].[myTable]"
        }
      ],
      "lastUpdateTime": "2017-05-30T07:16:08.21Z"
    }
  ]
}

정의

Name	Description
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
SyncFullSchemaProperties	데이터베이스 전체 스키마의 속성입니다.
SyncFullSchemaPropertiesListResult	동기화 스키마 속성 목록입니다.
SyncFullSchemaTable	데이터베이스 전체 스키마에 있는 테이블의 속성입니다.
SyncFullSchemaTableColumn	데이터베이스 전체 스키마 테이블에 있는 열의 속성입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

SyncFullSchemaProperties

Object

데이터베이스 전체 스키마의 속성입니다.

Name	형식	Description
lastUpdateTime	string (date-time)	데이터베이스 스키마의 마지막 업데이트 시간입니다.
tables	SyncFullSchemaTable[]	데이터베이스 전체 스키마의 테이블 목록입니다.

SyncFullSchemaPropertiesListResult

Object

동기화 스키마 속성 목록입니다.

Name	형식	Description
nextLink	string	결과의 다음 페이지를 검색하는 링크입니다.
value	SyncFullSchemaProperties[]	결과 배열입니다.

SyncFullSchemaTable

Object

데이터베이스 전체 스키마에 있는 테이블의 속성입니다.

Name	형식	Description
columns	SyncFullSchemaTableColumn[]	데이터베이스 전체 스키마 테이블의 열 목록입니다.
errorId	string	테이블의 오류 ID입니다.
hasError	boolean	테이블에 오류가 있는 경우
name	string	테이블의 이름입니다.
quotedName	string	테이블의 따옴표로 묶인 이름입니다.

SyncFullSchemaTableColumn

Object

데이터베이스 전체 스키마 테이블에 있는 열의 속성입니다.

Name	형식	Description
dataSize	string	열의 데이터 크기입니다.
dataType	string	열의 데이터 형식입니다.
errorId	string	열의 오류 ID입니다.
hasError	boolean	테이블에 오류가 있는 경우
isPrimaryKey	boolean	테이블의 기본 키인 경우
name	string	열의 이름입니다.
quotedName	string	열의 따옴표로 묶인 이름입니다.

다음을 통해 공유

Sync Groups - List Hub Schemas

URI 매개 변수

응답

예제

Get a hub database schema.

샘플 요청

샘플 응답

정의

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SyncFullSchemaProperties

SyncFullSchemaPropertiesListResult

SyncFullSchemaTable

SyncFullSchemaTableColumn