Gestione del supporto proxy

Questo articolo descrive come abilitare il supporto proxy nel connettore personalizzato di Power Query usando Power Query SDK.

Impostazioni proxy di Windows

Prima di tutto è necessario configurare le impostazioni proxy in Windows. Esistono due modi per configurare il proxy, tramite Opzioni Internet o l'impostazione Rete e Internet.

Opzioni Internet

1. Dal menu Start di Windows cercare e aprire Opzioni Internet.
2. Selezionare la scheda Connessioni.
3. Selezionare Impostazioni LAN.
4. Nella sezione Server proxy configurare il server proxy.

Rete e Internet

1. Dal menu Start di Windows selezionare l'icona Impostazioni .
2. In Impostazioni selezionare Rete e Internet (Windows 10) oppure selezionare l'icona Apri navigazione e quindi rete e Internet (Windows 11).
3. Selezionare Proxy.
4. Nella sezione Installazione manuale del proxy attivare o disattivare il pulsante Usa un server proxy (Windows 10) oppure selezionare il pulsante Configura e attivare o disattivare il pulsante Usa un server proxy (Windows 11).
5. Configurare l'indirizzo e la porta.

Abilitazione del supporto proxy

Una Web.DefaultProxy funzione è stata aggiunta al modulo di estendibilità. I connettori M di terze parti possono usare questa funzione per recuperare le impostazioni del proxy Web da impostare nelle proprietà del driver (quando il proxy è abilitato come descritto in Impostazioni proxy di Windows).

Le informazioni sul proxy possono essere impostate nella stringa di connessione rispetto al parametro di connessione, che può variare in base ai connettori. Le credenziali proxy (nome utente e password) non sono supportate. Web.DefaultProxy accetta serverUri/host come parametro e restituisce un record contenente l'URI proxy come ProxyUri campo di un record. Per ottenere le parti costitutive dell'URI , ad esempio schema, host, porta, all'interno del connettore, usare Uri.Parts.

Se il proxy non è configurato, Web.DefaultProxy restituisce un record vuoto.

Esempio di utilizzo

Esempio 1

Per utilizzare Web.DefaultProxy nel codice del connettore, è possibile usare una variabile di tipo booleano per consentire o rifiutare l'uso di questa funzionalità. In questo esempio, Web.DefaultProxy viene richiamato nel codice del connettore se il parametro UseWebDefaultProxy booleano facoltativo è impostato su true (il valore predefinito è false).

UseWebDefaultProxyOption = options[UseWebDefaultProxy]?,
ProxyUriRecord = if UseWebDefaultProxyOption then Web.DefaultProxy(Host) else null,
ProxyOptions = if Record.FieldCount(ProxyUriRecord) > 0 then
      [
            Proxy = ProxyUriRecord[ProxyUri]
      ]
      else [],
      ...

Quando l'oggetto UseWebDefaultProxy è impostato su true e ProxyUriRecord viene recuperato, è possibile creare un record per impostare il Proxy (parametro di configurazione supportato dal driver, che può variare) con il ProxyUri campo restituito da Web.DefaultProxy. Può essere denominato come ProxyOptions. Questo record può quindi essere aggiunto alla base ConnectionStringe includere i dettagli del proxy insieme a esso.

Databases = Odbc.DataSource(ConnectionString & ProxyOptions, Options)

Esempio 2

Se sono presenti più parametri di configurazione usati dal driver per impostare i dettagli del proxy ,ad esempio i dettagli dell'host e della porta gestiti separatamente, Uri.Parts è possibile usare .

UseWebDefaultProxyOption = options[UseWebDefaultProxy]?,
ProxyRecord = if UseWebDefaultProxyOption then Web.DefaultProxy(Host) else null,
UriRecord = if ProxyRecord <> null then Uri.Parts(ProxyRecord) else null,
ProxyOptions = if UriRecord <> null then
    [
        ProxyHost = UriRecord[Scheme] & "://" & UriRecord[Host],
        ProxyPort = UriRecord[Port]
    ]
    else [],
    ...