Condividi tramite

Dettagli del servizio e limitazioni delle Funzioni per i dati utente di Fabric

Questo articolo illustra in dettaglio le limitazioni correnti e i dettagli del servizio delle Funzioni per i dati utente di Fabric.

Rapporti sulla capacità

L'utilizzo delle Funzioni per i dati utente di Fabric viene segnalato nell'applicazione Fabric Capacity Metrics. I report sulla capacità tengono conto della creazione, pubblicazione, esecuzione e archiviazione delle Funzioni per i dati utente di Fabric. Per altre informazioni sui contatori segnalati nell'app Fabric Capacity Metrics, vedere Operazioni di Fabric.

Requisiti di sicurezza di rete

Per consentire il corretto funzionamento di Funzioni dati utente di Fabric, la rete deve consentire richieste e caricamenti di file in endpoint di Fabric con "multipart/form-data". Se questo requisito non è presente, le richieste seguenti possono generare un errore CORS (Cross-origin Resource Sharing): funzioni di pubblicazione e caricamento di librerie personalizzate.

Limitazioni

Di seguito sono riportate le limitazioni correnti per Le funzioni dati utente di Fabric:

  • Le funzioni sono modificabili solo dal proprietario: in questo momento, solo il proprietario dell'elemento Funzioni dati utente può modificare e pubblicare il codice delle funzioni. Per istruzioni su come trasferire la proprietà degli elementi di Fabric, vedere Acquisire la proprietà degli elementi di Fabric.

  • Le funzioni pubblicano il periodo di raffreddamento: dopo la pubblicazione delle funzioni, è necessario attendere almeno 2 minuti prima della pubblicazione di nuovo. Questo periodo di raffreddamento è applicabile durante la pubblicazione dal portale di Funzioni nel browser, l'estensione Funzioni dati utente di Visual Studio Code, l'azione di importazione GIT o tramite le pipeline di distribuzione.

  • "Gestisci connessioni" supporta solo origini dati di Fabric: la funzionalità "Gestisci connessioni" supporta solo la connessione alle origini dati native di Fabric in questo momento. Per saperne di più, visita Connect to data sources.

  • "Gestisci connessioni" non può connettersi alle risorse con caratteri speciali nei nomi: le risorse di Infrastruttura, ad esempio i database, con caratteri speciali nei nomi, ad esempio parentesi graffe o caratteri non ASCII, non sono compatibili con l'esperienza Gestisci connessioni in Funzioni dati utente. Per saperne di più, visita Connect to data sources.

  • Limitazioni a livello di area per Funzioni dati utente: le funzioni dati utente non sono disponibili in un subset di aree di Fabric. Per un elenco aggiornato delle aree in cui è disponibile Funzioni per i dati utente di Fabric, vedere Disponibilità delle aree di Fabric. Se il tuo Home Tenant si trova in un'area non supportata, è possibile creare una Capacity in un'area supportata per utilizzare le funzioni per i dati utente. Per ulteriori informazioni, vedere Gestire la capacità di Fabric.

  • Limitazioni internazionali per la funzionalità test in modalità sviluppo: la funzionalità di test in modalità sviluppo non è disponibile nelle aree di infrastruttura seguenti: Brasile meridionale, Israele centrale e Messico centrale. È comunque possibile testare le funzioni pubblicandole ed eseguirle oppure usando l'estensione VS Code per testarle in locale.

  • Parole chiave Python riservate in Funzioni dati utente di Fabric: oltre alle parole chiave riservate del linguaggio Python, Fabric User Data Functions usa anche le parole chiave seguenti: req, contexte reqInvocationId. Le parole chiave riservate non possono essere usate come nomi di parametri o nomi di funzione.

  • I parametri con valori predefiniti o valori facoltativi non sono supportati: al momento, tutti i parametri della funzione sono necessari quando si richiama la chiamata. Analogamente, l'impostazione dei valori predefiniti nella definizione dell'argomento della funzione non è attualmente supportata. Ad esempio, la funzione seguente genera un errore di sintassi:

        # The default value for the argument called 'name' is not supported and treated like a syntax error.
    @udf.function()
    def goodbye_fabric(name: str = "N/A") -> str:
        return f"Goodbye, {name}."

  • Supporto dell'entità servizio: l'accesso a elementi o origini dati di Fabric tramite un'entità servizio non è attualmente supportato. Ad esempio, non è possibile usare Funzioni dati utente di Fabric come identità gestita o identità dell'area di lavoro.

Limiti del servizio

L'elenco seguente illustra in dettaglio i limiti del servizio per gli elementi delle Funzioni per i dati utente.

Limite Valore Descrizione
Lunghezza payload richiesta 4 MB Dimensione massima di tutti i parametri della richiesta combinati.
Timeout di esecuzione della richiesta 240 secondi Quantità massima di tempo per cui una funzione può essere eseguita.
Limite di dimensioni della risposta 30 Megabyte Dimensione massima del valore restituito della risposta di una funzione.
Conservazione dei log 30 giorni Numero di giorni per cui i log delle chiamate cronologiche vengono conservati per impostazione predefinita.
Dimensioni massime della libreria privata 28,6 MB Dimensioni massime di un .whl file caricato nell'esperienza di gestione delle librerie come libreria privata.
Test nel timeout del portale 15 minuti Periodo di tempo per cui la sessione di test è attiva fino a quando non viene elaborata una nuova richiesta. La sessione viene estesa di 15 minuti quando viene ricevuta una nuova richiesta entro il periodo di timeout.
Versione di Python (funzionalità di esecuzione) 3.11 Versione di Python usata per le funzioni pubblicate in modalità Solo esecuzione.
Versione di Python (funzionalità di test) 3.12 Versione di Python usata per la funzionalità di test in modalità Sviluppo.

Passaggi successivi

  • Last updated on