Partilhar via

Web

  • Artigo

Resumo

Item Description
Estado de Lançamento Disponibilidade Geral
Produtos Excel
Power BI (modelos semânticos)
Power BI (Fluxos de Dados)
Malha (Dataflow Gen2)
Power Apps (Fluxos de Dados)
Dynamics 365 Customer Insights
Tipos de autenticação suportados Web.Conteúdo:
Anónimo
Windows
Básica
API da Web
Conta Organizacional
Principal de Serviço

Web.BrowserConteúdo:
Anónimo
Windows
Básica
API da Web

Web.Page:
Anónimo
Windows (somente credenciais do usuário atual)
API da Web
Documentação de referência da função Web.Conteúdos
Web.BrowserConteúdos
Web.Page

Nota

O tipo de autenticação da entidade de serviço não é suportado ao usar um gateway de dados local ou um gateway de dados de rede virtual (VNet).

Nota

As solicitações POST só podem ser feitas anonimamente ao usar Web.Contentso .

Nota

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Pré-requisitos

  • Web.Page requer o Internet Explorer 10.
  • Web.BrowserContents requer o tempo de execução WebView2 do Microsoft Edge.

Capacidades suportadas

  • Ligar a um URL
  • Avançado
    • Usando uma combinação de constantes de texto e parâmetros para construir a URL
    • Especificando um tempo limite de comando
    • Definindo parâmetros de cabeçalho de solicitação HTTP (somente Web.Content )

Carregar dados da Web utilizando o Power Query Desktop

Para carregar dados de um Web site com o Power Query Desktop:

  1. Selecione Obter Dados > Web no Power BI ou Da Web na faixa de opções Dados no Excel.

  2. Escolha o botão Básico e insira um endereço URL na caixa de texto. Por exemplo, introduza https://en.wikipedia.org/wiki/List_of_states_and_territories_of_the_United_States. Em seguida, selecione OK.

    Seleção de arquivos de texto.

    Se o endereço URL introduzido for inválido, será apresentado um Ícone de aviso.ícone de aviso junto à caixa de texto URL.

    Se você precisar construir uma URL mais avançada antes de se conectar ao site, vá para Carregar dados da Web usando uma URL avançada.

  3. Selecione o método de autenticação a ser usado para este site. Neste exemplo, selecione Anônimo. Em seguida, selecione o nível ao qual deseja aplicar essas configurações — neste caso, https://en.wikipedia.org/. Em seguida, selecione Conectar.

    Seleção de credenciais da Web.

    Os métodos de autenticação disponíveis para este conector são:

    • Anônimo: selecione este método de autenticação se a página da Web não exigir credenciais.

    • Windows: Selecione este método de autenticação se a página Web exigir as suas credenciais do Windows.

    • Básico: Selecione este método de autenticação se a página da Web exigir um nome de usuário e senha básicos.

    • API da Web: selecione esse método se o recurso da Web ao qual você está se conectando usar uma chave de API para fins de autenticação.

    • Conta organizacional: selecione este método de autenticação se a página da Web exigir credenciais de conta organizacional.

    O nível selecionado para o método de autenticação determina qual parte de uma URL terá o método de autenticação aplicado a ela. Se você selecionar o endereço da Web de nível superior, o método de autenticação selecionado aqui será usado para esse endereço URL ou qualquer subendereço dentro desse endereço. No entanto, talvez você não queira definir o endereço URL superior para um método de autenticação específico, pois subendereços diferentes podem exigir métodos de autenticação diferentes. Por exemplo, se você estava acessando duas pastas separadas de um único site do SharePoint e queria usar contas da Microsoft diferentes para acessar cada uma.

    Depois de definir o método de autenticação para um endereço de site específico, você não precisará selecionar o método de autenticação para esse endereço URL ou qualquer subendereço novamente. Por exemplo, se você selecionar o https://en.wikipedia.org/ endereço nessa caixa de diálogo, qualquer página da Web que comece com esse endereço não exigirá que você selecione o método de autenticação novamente.

    Nota

    Se você precisar alterar o método de autenticação mais tarde, vá para Alterando o método de autenticação.

  4. Na caixa de diálogo Navegador, pode selecionar uma tabela e, em seguida, transformar os dados no editor do Power Query selecionando Transformar Dados ou carregar os dados selecionando Carregar.

    Seleção de tabelas da Web.

    O lado direito da caixa de diálogo Navegador exibe o conteúdo da tabela selecionada para transformar ou carregar. Se não tiver certeza de qual tabela contém os dados em que está interessado, selecione a guia Exibição da Web. A vista Web permite-lhe ver todo o conteúdo da página Web e realça cada uma das tabelas que foram detetadas nesse site. Você pode marcar a caixa de seleção acima da tabela realçada para obter os dados dessa tabela.

    No canto inferior esquerdo da caixa de diálogo Navegador , você também pode selecionar o botão Adicionar tabela usando exemplos . Esta seleção apresenta uma janela interativa onde você pode visualizar o conteúdo da página da Web e inserir valores de exemplo dos dados que deseja extrair. Para obter mais informações sobre como usar esse recurso, vá para Obter dados da página da Web fornecendo exemplos.

Carregar dados da Web utilizando o Power Query Online

Para carregar dados de um Web site com o Power Query Online:

  1. Na caixa de diálogo Obter Dados, selecione Página da Web ou API da Web.

    Selecione a página da Web ou o conector da API da Web.

    Na maioria dos casos, convém selecionar o conector de página da Web. Por motivos de segurança, você precisará usar um gateway de dados local com esse conector. O conector de página da Web requer um gateway porque as páginas HTML são recuperadas usando um controle de navegador, o que envolve possíveis preocupações de segurança. Essa preocupação não é um problema com o conector de API da Web, pois ele não usa um controle de navegador.

    Em alguns casos, talvez você queira usar uma URL que aponte para uma API ou um arquivo armazenado na Web. Nesses cenários, o conector da API Web (ou conectores específicos de arquivo) permitiria que você avançasse sem usar um gateway de dados local.

    Observe também que, se a URL apontar para um arquivo, você deverá usar o conector de arquivo específico em vez do conector de página da Web.

  2. Insira um endereço URL na caixa de texto. Para este exemplo, digite https://en.wikipedia.org/wiki/List_of_states_and_territories_of_the_United_States.

    Introduza o URL da página Web.

  3. Selecione o nome do seu gateway de dados local.

    Insira seu gateway de dados local.

  4. Selecione o método de autenticação que você usará para se conectar à página da Web.

    Selecione o método de autenticação.

    Os métodos de autenticação disponíveis para este conector são:

    • Anônimo: selecione este método de autenticação se a página da Web não exigir credenciais.

    • Windows: Selecione este método de autenticação se a página Web exigir as suas credenciais do Windows.

    • Básico: Selecione este método de autenticação se a página da Web exigir um nome de usuário e senha básicos.

    • Conta organizacional: selecione este método de autenticação se a página da Web exigir credenciais de conta organizacional.

    Depois de escolher o método de autenticação, selecione Avançar.

  5. Na caixa de diálogo Navegador, pode selecionar uma tabela e, em seguida, transformar os dados no Editor do Power Query selecionando Transformar Dados.

    Caixa de diálogo Navegador mostrando estados da página da Web.

Carregar dados da Web usando uma URL avançada

Quando seleciona Obter Dados > da Web no Power Query Desktop, na maioria dos casos, introduz URLs na definição Básica. No entanto, em alguns casos, você pode querer montar uma URL a partir de suas partes separadas, definir um tempo limite para a conexão ou fornecer dados de cabeçalho de URL individualizados. Nesse caso, selecione a opção Avançado na caixa de diálogo Da Web .

Montagem avançada de URL da Web.

Use a seção Partes da URL da caixa de diálogo para montar a URL que você deseja usar para obter dados. A primeira parte da URL na seção de partes da URL provavelmente consistiria no esquema, autoridade e caminho do URI (por exemplo, http://contoso.com/products/). A segunda caixa de texto pode incluir quaisquer consultas ou fragmentos que você usaria para filtrar as informações fornecidas ao site. Se você precisar adicionar mais de uma parte, selecione Adicionar parte para adicionar outra caixa de texto de fragmento de URL. À medida que você insere cada parte do URL, o URL completo que será usado quando você selecionar OK é exibido na caixa de visualização do URL.

Dependendo de quanto tempo a solicitação POST leva para processar dados, talvez seja necessário prolongar o tempo em que a solicitação continua conectada ao site. O tempo limite padrão para POST e GET é de 100 segundos. Se esse tempo limite for muito curto, você poderá usar o tempo limite de comando opcional em minutos para estender o número de minutos que você permanece conectado.

Você também pode adicionar cabeçalhos de solicitação específicos ao POST enviado para o site usando a caixa suspensa opcional de parâmetros de cabeçalho de solicitação HTTP. A tabela a seguir descreve os cabeçalhos de solicitação que você pode selecionar.

Cabeçalho do Pedido Description
Accept Especifica os tipos de mídia de resposta que são aceitáveis.
Aceitar-Charset Indica quais conjuntos de caracteres são aceitáveis no conteúdo da resposta textual.
Accept-Encoding Indica quais codificações de conteúdo de resposta são aceitáveis na resposta.
Accept-Language Indica o conjunto de linguagens naturais preferidas na resposta.
Cache-Controle Indica as políticas de cache, especificadas por diretivas, em solicitações de cliente e respostas de servidor.
Tipo de Conteúdo Indica o tipo de mídia do conteúdo.
Se-Modificado-Desde Determina condicionalmente se o conteúdo da Web foi alterado desde a data especificada neste campo. Se o conteúdo não tiver sido alterado, o servidor responderá apenas com os cabeçalhos que têm um código de status 304. Se o conteúdo tiver sido alterado, o servidor retornará o recurso solicitado junto com um código de status de 200.
Prefira Indica que determinados comportamentos de servidor são preferidos pelo cliente, mas não são necessários para a conclusão bem-sucedida da solicitação.
Intervalo Especifica um ou mais subintervalos dos dados de representação selecionados.
Referer Especifica uma referência de URI para o recurso do qual o URI de destino foi obtido.

Importar arquivos da Web

Normalmente, quando importa um ficheiro local no Power Query Desktop, utiliza o conector de tipo de ficheiro específico para importar esse ficheiro, por exemplo, o conector JSON para importar um ficheiro JSON ou o conector CSV para importar um ficheiro CSV. No entanto, se estiver a utilizar o Power Query Desktop e o ficheiro que pretende importar estiver localizado na Web, tem de utilizar o conector Web para importar esse ficheiro. Como no caso local, você verá a tabela que o conector carrega por padrão, que pode ser Carregar ou Transformar.

Os seguintes tipos de arquivo são suportados pelo Web Connector:

Por exemplo, você pode usar as seguintes etapas para importar um arquivo JSON no https://contoso.com/products site:

  1. Na caixa de diálogo Obter Dados, selecione o conector Web.

  2. Escolha o botão Básico e digite o endereço na caixa URL , por exemplo:

    http://contoso.com/products/Example_JSON.json

    Importe um arquivo JSON da Web.

  3. Selecione OK.

  4. Se esta for a primeira vez que visita este URL, selecione Anónimo como o tipo de autenticação e, em seguida, selecione Ligar.

  5. O Power Query Editor será agora aberto com os dados importados do ficheiro JSON. Selecione o separador Ver no Editor do Power Query e, em seguida, selecione Barra de Fórmulas para ativar a barra de fórmulas no editor.

    Abra a Barra de Fórmulas.

    Como você pode ver, o conector da Web retorna o conteúdo da Web da URL fornecida e, em seguida, encapsula automaticamente o conteúdo da Web no tipo de documento apropriado especificado pela URL (Json.Document neste exemplo).

Consulte também