Compartilhar via

Detalhes do serviço e limitações das Funções de dados do usuário do Fabric

Este artigo apresenta os detalhes do serviço e as limitações atuais das Funções de dados do usuário do Fabric.

Relatórios de capacidade

O uso das Funções de dados do usuário do Fabric é relatado no aplicativo de Métricas de Capacidade do Fabric. Os relatórios de capacidade são responsáveis pela criação, publicação, execução e armazenamento das Funções de dados do usuário do Fabric. Para saber mais sobre os medidores relatados no aplicativo de Métricas de Capacidade do Fabric, visite Operações do Fabric.

Requisitos de segurança de rede

Para que as Funções de Dados do Usuário do Fabric funcionem corretamente, sua rede deve permitir solicitações de "vários dados de formulário" e uploads de arquivos para pontos de extremidade do Fabric. Se esse requisito não estiver em vigor, as seguintes solicitações poderão resultar em um erro cors (CORS) de compartilhamento de recursos entre origens: publicando funções e carregando bibliotecas personalizadas.

Limitações

Veja a seguir as limitações atuais para as funções de dados do usuário do Fabric:

  • As funções são editáveis somente pelo proprietário: neste momento, somente o proprietário do item Funções de Dados do Usuário pode modificar e publicar o código de 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 espera para publicar funções: Após a publicação das suas funções, você precisa esperar pelo menos 2 minutos antes de publicar novamente. Esse período de espera é aplicável ao publicar no portal do navegador do Functions, na extensão User Data Functions do Visual Studio Code, na ação de importação do Git ou usando pipelines de implantação.

  • "Gerenciar conexões" só dá suporte a fontes de dados do Fabric: o recurso "Gerenciar conexões" só dá suporte à conexão com fontes de dados nativas do Fabric neste momento. Para saber mais, visite Conectar-se às fontes de dados.

  • "Gerenciar conexões" não pode se conectar a recursos que têm 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 Conectar-se às 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 do Fabric. Para obter uma lista atualizada de regiões em que as Funções de dados do usuário estão disponíveis, consulte Disponibilidade da região do Fabric. Se o Locatário Inicial estiver em uma região sem suporte, você poderá criar uma capacidade em uma região com suporte para usar as Funções de dados do usuário. Para obter mais informações, consulte Gerenciar sua capacidade do Fabric.

  • Limitações regionais para o recurso teste no modo Desenvolver: a funcionalidade de teste no modo Desenvolver não está disponível nas seguintes regiões do Fabric: 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 reservadas do Python em Funções de Dados do Usuário do Fabric: além de palavras-chave reservadas da linguagem Python, o Fabric User Data Functions também usa as seguintes palavras-chave: req, contexte reqInvocationId. Palavras-chave reservadas não podem ser usadas como nomes de parâmetro ou nomes de função.

  • Parâmetros com valores padrão ou valores opcionais não têm suporte: neste momento, todos os parâmetros de função são necessários ao invocar a invocação. Da mesma forma, atualmente, não há suporte para fornecer valores padrão na definição de argumento de função. Por exemplo, a função abaixo gera 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 à entidade de serviço: no momento, não há suporte para acessar itens do Fabric ou fontes de dados usando uma Entidade de Serviço. Por exemplo, você não pode usar o Fabric User Data Functions como uma identidade gerenciada ou uma identidade de workspace.

Limites de serviço

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

Limite Valor Descrição
Solicitar duração de carga 4 MB O tamanho máximo de todos os parâmetros da solicitação combinados.
Tempo limite de execução da solicitação 240 segundos O tempo máximo de execução de uma função.
Limite de tamanho da resposta 30 MB O tamanho máximo do valor retornado da resposta de uma função.
Retenção de log 30 dias O número de dias em que os registros históricos de invocação são mantidos por padrão.
Tamanho máximo da biblioteca privada 28,6 MB O tamanho máximo de um .whl arquivo carregado na experiência de Gerenciamento de Biblioteca como uma biblioteca privada.
Testar no tempo limite do portal 15 minutos O tempo para o qual a sessão de teste está ativa até que uma nova solicitação seja processada. A sessão é estendida por 15 minutos quando uma nova solicitação é recebida dentro do período de tempo limite.
Versão do Python (capacidade de execução) 3.11 A versão do Python usada para funções publicadas no modo Somente Execução.
Versão do Python (capacidade de teste) 3.12 A versão do Python usada para a funcionalidade de teste no modo Desenvolver.

Próximas etapas

  • Last updated on