Sync Groups - List Hub Schemas

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém uma coleção de esquemas de banco de dados de hub.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
databaseName	path	True	string	O nome do banco de dados no qual o grupo de sincronização está hospedado.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
syncGroupName	path	True	string	O nome do grupo de sincronização.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Respostas

Nome	Tipo	Description
200 OK	SyncFullSchemaPropertiesListResult	Obtenha com êxito um esquema de banco de dados do hub de grupo de sincronização.
Other Status Codes		Respostas de erro: *** 400 InvalidSyncGroupCreateOrUpdateRequest - O corpo da solicitação do grupo de sincronização criar ou atualizar está vazio. 400 InvalidSyncMemberCreateOrUpdateRequest - O corpo da solicitação do membro de sincronização criar ou atualizar está vazio. 400 InvalidSyncAgentCreateOrUpdateRequest - O corpo da solicitação do agente de sincronização de criação ou atualização está vazio. 400 InvalidDatabaseResourceId - Identificador de recurso de banco de dados inválido. 400 MismatchingSubscriptionWithUrl - A assinatura fornecida não correspondeu à assinatura na URL. 400 InvalidSyncAgentResourceId - Identificador de recurso do agente de sincronização inválido. 400 MismatchingResourceGroupNameWithUrl - O nome do grupo de recursos fornecido não correspondeu ao nome na URL. 400 MismatchingServerNameWithUrl - O nome do servidor fornecido não correspondeu ao nome na URL. 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro. 400 MissingServerName - O nome do servidor está ausente 400 MissingDatabaseName - O nome do banco de dados está ausente 400 MissingSyncGroupName - O nome do Grupo de Sincronização está ausente 400 MissingConflictResolutionPolicy - A Política de Resolução de Conflitos está ausente 400 MissingSyncAgentName - O nome do Agente de Sincronização está ausente 400 SyncOperation_GenericFailure – Falha ao executar a operação de sincronização de dados. 400 InvalidSyncGroup - O grupo de sincronização é inválido. 400 FeatureDisabledOnSelectedEdition - O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados. 400 CannotCreateSyncGroupDueToQuotaExceeded - Não é possível criar um grupo de sincronização devido à cota excedida. 400 SyncOperation_DuplicateSyncGroupDrop - O grupo de sincronização já está sendo descartado. 400 SyncOperation_WrongSyncDatabase - O banco de dados de sincronização especificado não corresponde ao existente. 400 SyncOperation_UpdateSyncGroupWhenDropping - Não é possível atualizar o grupo de sincronização porque ele está sendo descartado no momento. 400 SyncOperation_DwInSyncGroup - Não é possível usar a edição datawarehouse na sincronização de dados. 400 SyncOperation_MasterDbInSyncGroup - Não é possível usar master lógicas na sincronização de dados. 400 SyncOperation_InvalidCredential – A credencial do banco de dados é inválida. 400 InvalidSyncMetadataDatabase - O banco de dados de metadados de sincronização é inválido. 400 SyncOperation_InvalidSyncInterval - Não é possível criar ou atualizar o grupo de sincronização porque o intervalo de sincronização é inválido. 404 ResourceNotFound - O recurso solicitado não foi encontrado. 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância de servidor. 404 SyncOperation_HubServerNotFound – O servidor lógico do hub não existe. 404 SyncOperation_InvalidHubDatabase – O banco de dados hub é inválido. 409 SyncOperation_DuplicateSyncGroupName - Não é possível criar um grupo de sincronização porque o grupo de sincronização com o mesmo nome já existe.

Exemplos

Get a hub database schema.

Solicitação de exemplo

HTTP

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=2021-11-01

Java

/**
 * Samples for SyncGroups ListHubSchemas.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/SyncGroupGetHubSchema.json
     */
    /**
     * Sample code: Get a hub database schema.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAHubDatabaseSchema(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getSyncGroups().listHubSchemas("syncgroupcrud-65440",
            "syncgroupcrud-8475", "syncgroupcrud-4328", "syncgroupcrud-3187", com.azure.core.util.Context.NONE);
    }
}

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

Resposta de exemplo

Código de status:

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

Definições

Nome	Description
SyncFullSchemaProperties	Propriedades do esquema completo do banco de dados.
SyncFullSchemaPropertiesListResult	Uma lista de propriedades de esquema de sincronização.
SyncFullSchemaTable	Propriedades da tabela no esquema completo do banco de dados.
SyncFullSchemaTableColumn	Propriedades da coluna na tabela do esquema completo do banco de dados.

SyncFullSchemaProperties

Propriedades do esquema completo do banco de dados.

Nome	Tipo	Description
lastUpdateTime	string	Hora da última atualização do esquema de banco de dados.
tables	SyncFullSchemaTable[]	Lista de tabelas no esquema completo do banco de dados.

SyncFullSchemaPropertiesListResult

Uma lista de propriedades de esquema de sincronização.

Nome	Tipo	Description
nextLink	string	Link para recuperar a próxima página de resultados.
value	SyncFullSchemaProperties[]	Matriz de resultados.

SyncFullSchemaTable

Propriedades da tabela no esquema completo do banco de dados.

Nome	Tipo	Description
columns	SyncFullSchemaTableColumn[]	Lista de colunas na tabela do esquema completo do banco de dados.
errorId	string	ID do erro da tabela.
hasError	boolean	Se houver um erro na tabela.
name	string	Nome da tabela.
quotedName	string	Nome entre aspas da tabela.

SyncFullSchemaTableColumn

Propriedades da coluna na tabela do esquema completo do banco de dados.

Nome	Tipo	Description
dataSize	string	Tamanho dos dados da coluna.
dataType	string	Tipo de dados da coluna.
errorId	string	ID do erro da coluna.
hasError	boolean	Se houver um erro na tabela.
isPrimaryKey	boolean	Se for a chave primária da tabela.
name	string	Nome da coluna.
quotedName	string	Nome entre aspas da coluna.