external_table()

Alterne os serviços usando a lista suspensa Versão. Saiba mais sobre navegação.
Aplica-se a: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Faz referência a uma tabela externa por nome.

Observação

A external_table função tem restrições semelhantes às da função de tabela . Os limites de consulta padrão também se aplicam a consultas de tabela externa.

Para acelerar consultas em tabelas delta externas, consulte Política de aceleração de consulta.

Sintaxe

external_table( TableName [,MappingName / MaxAgeOverride ] )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatória Descrição
TableName string ✔️ O nome da tabela externa que está sendo consultada. Deve fazer referência a uma tabela externa do tipo blob, adl, ou sql.
Nome do mapeamento string Um nome de um objeto de mapeamento que mapeia campos nos fragmentos de dados externos para a saída de colunas.
MaxAgeOverride TimeSpan Quando a Política de Aceleração de Consulta estiver habilitada, substitua a propriedade MaxAge da política para essa consulta. Se você usar essa propriedade, a tabela externa retornará dados acelerados se a hora de atualização do último índice for maior que @now - MaxAgeOverride. Mínimo: 1s

Autenticação e autorização

O método de autenticação para acessar uma tabela externa é baseado na cadeia de conexão fornecida durante sua criação, e as permissões necessárias para acessar a tabela variam dependendo do método de autenticação. Para obter mais informações, consulte Tabela externa do Armazenamento do Azure ou Tabela externa do SQL Server.

Usar em consultas de política de atualização

A external_table() função pode ser usada dentro de consultas de política de atualização em condições restritas:

  • A tabela externa deve ter uma política de aceleração de consultahabilitada.
  • O período de aceleração Hot de consulta deve abranger todos os dados na tabela externa (atualmente >= 100 anos).
  • Se a tabela externa usar a autenticação de representação, a política de atualização deverá ser configurada com um ManagedIdentity.
  • Em Fabric, o sistema manipula automaticamente a autorização por meio da OwnerPrincipalDetails propriedade na política de atualização, que captura a identidade do usuário que define ou altera a política.

Para obter mais informações, consulte a visão geral da política de atualização – limitações de consulta.

Conteúdo relacionado

  • Last updated on