Database Tables - List By Schema

Serviço:

SQL Database

Versão da API:

2021-11-01

Listar tabelas do banco de dados

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

Com parâmetros opcionais:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/schemas/{schemaName}/tables?$filter={$filter}&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.
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.
schemaName	path	True	string	O nome do esquema.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.
$filter	query		string	Uma expressão de filtro OData que filtra elementos na coleção.

Respostas

Nome	Tipo	Description
200 OK	DatabaseTableListResult	Tabelas de banco de dados recuperadas com êxito.
Other Status Codes		Respostas de erro: *** 400 UpdateNotAllowedOnPausedDatabase – O usuário tentou executar uma atualização em um banco de dados em pausa. 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado 404 SourceDatabaseNotFound – O banco de dados de origem não existe. 404 DatabaseDoesNotExist – o usuário especificou um nome de banco de dados que não existe nesta instância do servidor. 404 ResourceDoesNotExist – o recurso com o nome '{0}' não existe. Para continuar, especifique um nome de recurso válido. 404 InvalidDatabaseSchema – O esquema está ausente no banco de dados. 404 InvalidDatabaseTable – a tabela está ausente no banco de dados. 404 InvalidDatabaseColumn – a coluna está ausente na tabela. 503 DatabaseUnavailable – A operação falhou porque o banco de dados não está disponível.

Exemplos

List database tables

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/serverName/databases/myDatabase/schemas/dbo/tables?api-version=2021-11-01

Java

/**
 * Samples for DatabaseTables ListBySchema.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseTableListBySchema.json
     */
    /**
     * Sample code: List database tables.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listDatabaseTables(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseTables().listBySchema("myRG", "serverName",
            "myDatabase", "dbo", null, 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": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/serverName/databases/myDatabase/schemas/dbo/tables/table1",
      "name": "table1",
      "type": "Microsoft.Sql/servers/databases/schemas/tables"
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/servers/serverName/databases/myDatabase/schemas/dbo/tables/table2",
      "name": "table2",
      "type": "Microsoft.Sql/servers/databases/schemas/tables"
    }
  ]
}

Definições

Nome	Description
DatabaseTable	Um recurso de tabela de banco de dados.
DatabaseTableListResult	Uma lista de tabelas de banco de dados.
TableTemporalType	O tipo temporal da tabela.

DatabaseTable

Um recurso de tabela de banco de dados.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.memoryOptimized	boolean	Se a tabela é ou não otimizada para memória.
properties.temporalType	TableTemporalType	O tipo temporal da tabela.
type	string	Tipo de recurso.

DatabaseTableListResult

Uma lista de tabelas de banco de dados.

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

TableTemporalType

O tipo temporal da tabela.

Nome	Tipo	Description
HistoryTable	string
NonTemporalTable	string
SystemVersionedTemporalTable	string