Partilhar via

Detalhes e limitações das funções de dados do utilizador do Fabric

Este artigo descreve os detalhes do serviço e as limitações atuais das Funções de Dados de Utilizador do Fabric.

Relatórios de capacidade

O uso das Funções de Dados do Utilizador do Fabric é reportado na aplicação Fabric Capacity Metrics. Os relatórios de capacidade são responsáveis pela criação, publicação, execução e armazenamento de funções de dados do usuário de Fabric. Para saber mais sobre as métricas relatadas na aplicação Fabric Capacity Metrics, visite operações de Fabric.

Requisitos de segurança da rede

Para que as Fabric User Data Functions funcionem corretamente, a sua rede deve permitir solicitações de "multipart/form-data" e uploads de arquivos para os endpoints do Fabric. Se esse requisito não estiver em vigor, as seguintes solicitações podem resultar em um erro de compartilhamento de recursos entre origens (CORS): funções de publicação e upload de bibliotecas personalizadas.

Limitações

As seguintes são as limitações atuais para as Funções de Dados do Utilizador do Fabric:

  • As funções são editáveis apenas pelo proprietário: Neste momento, apenas o proprietário do item Funções de Dados do Usuário pode modificar e publicar o código das funções. Para obter instruções sobre como transferir a propriedade de itens do Fabric, consulte Assumir a propriedade de itens do Fabric.

  • Período de pausa para publicação de funções: Depois de publicar as funções, você precisa esperar pelo menos 2 minutos antes de publicar novamente. Esse período de resfriamento é aplicável ao publicar a partir do portal Functions no navegador, da extensão User Data Functions Visual Studio Code, da ação de importação GIT ou usando pipelines de implantação.

  • "Gerir ligações" apenas suporta fontes de dados Fabric: A funcionalidade "Gerir ligações" apenas oferece suporte à conexão com fontes de dados nativas Fabric neste momento. Para saber mais, visite Ligar a fontes de dados.

  • "Gerenciar conexões" não pode se conectar a recursos que tenham caracteres especiais em seus nomes: recursos de malha, como bancos de dados, que têm caracteres especiais em seus nomes, como chaves ou caracteres não-ASCII, não são compatíveis com a experiência Gerenciar conexões em funções de dados do usuário. Para saber mais, visite Ligar a fontes de dados.

  • Limitações regionais para funções de dados do usuário: as funções de dados do usuário não estão disponíveis em um subconjunto de regiões de malha. Para obter uma lista atualizada das regiões onde as Funções de Dados do Utilizador do Fabric estão disponíveis, consulte disponibilidade de regiões do Fabric. Se o seu Inquilino Doméstico estiver numa região sem suporte, pode criar uma Capacidade numa região suportada para utilizar as Funções de Dados do Utilizador. Para mais informações, consulte Gerir a sua capacidade do Fabric.

  • Limitações regionais para o recurso Teste no modo Desenvolvimento: A funcionalidade de teste no modo Desenvolvimento não está disponível nas seguintes regiões de malha: Sul do Brasil, Israel Central e México Central. Você ainda pode testar suas funções publicando-as e executando-as, ou usando a extensão VS Code para testá-las localmente.

  • Palavras-chave Python reservadas em Fabric User Data Functions: Além das palavras-chave reservadas da linguagem Python, Fabric User Data Functions também usa as seguintes palavras-chave: req, context, e reqInvocationId. Palavras-chave reservadas não podem ser usadas como nomes de parâmetros ou nomes de funções.

  • Parâmetros com valores padrão ou valores opcionais não são suportados: Neste momento, todos os parâmetros de função são necessários ao invocar invocação. Da mesma forma, o fornecimento de valores padrão na definição de argumento de função não é suportado no momento. Por exemplo, a função abaixo lança um erro de sintaxe:

        # 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}."

  • Suporte do principal de serviço: o acesso a itens do Fabric ou fontes de dados usando um principal de serviço não é atualmente suportado. Por exemplo, não é possível usar Fabric User Data Functions como uma identidade gerenciada ou identidade de espaço de trabalho.

Limites de serviço

A lista a seguir detalha os limites de serviço para itens de Funções de Dados do Usuário.

Limite Valor Descrição
Solicitar comprimento da carga útil 4 MB O tamanho máximo de todos os parâmetros de solicitação combinados.
Tempo limite de execução da solicitação 240 segundos A quantidade máxima de tempo que uma função pode ser executada.
Limite de tamanho de resposta 30 MB O tamanho máximo do valor de retorno da resposta de uma função.
Retenção de logs 30 dias O número de dias pelos quais os logs de invocação históricos são retidos por padrão.
Tamanho máximo da biblioteca privada 28,6 MB O tamanho máximo de um ficheiro .whl carregado para a experiência de Gestão da Biblioteca como uma biblioteca privada.
Teste no tempo de expiração do portal 15 minutos A quantidade de tempo que a sessão de teste fica ativa até que uma nova solicitação seja processada. A sessão é prolongada em 15 minutos quando um novo pedido é recebido dentro do período de tempo limite.
Versão Python (capacidade de execução) 3.11 A versão Python usada para funções publicadas no modo Run only.
Versão Python (capacidade de teste) 3.12 A versão Python usada para a capacidade de teste no modo de desenvolvimento.

Próximos passos

  • Last updated on