Criar e usar pontos de extremidade privados gerenciados

Os utilizadores com permissões de administrador para um espaço de trabalho do Microsoft Fabric podem criar, visualizar e excluir pontos de extremidade privados geridos a partir do portal do Fabric através das definições do espaço de trabalho.

• O utilizador também pode monitorizar o estado e o processo de aprovação dos pontos finais privados geridos na secção Segurança de Rede das definições do espaço de trabalho.

• O utilizador pode aceder às fontes de dados usando o nome do ponto de extremidade privado das tarefas do Fabric Spark.

Pré-requisitos

Um provedor de recursos Microsoft.Network precisa estar registrado na assinatura do Azure

Criar um ponto final privado gerido

1. No workspace do Fabric, navegue até às definições do espaço de trabalho, selecione o separador Segurança de rede e, em seguida, selecione a opção Criar na secção Ponto de Extremidade Privado Gerido.

   

   O diálogo Criar ponto final privado gerido é aberto.

   

2. Especifique um nome para o ponto de extremidade privado e copie o identificador de recurso no recurso do Azure. O identificador de recurso pode ser encontrado na guia de propriedades na página do portal do Azure. Para obter mais informações, consulte: Como obter sua ID de recurso do Azure

   Nota

   Não há suporte para a criação de um ponto de extremidade privado gerenciado com um nome de domínio totalmente qualificado (FQDN).

   Quando terminar, selecione Criar.

3. Quando o ponto de extremidade privado gerenciado é provisionado, o status de ativação muda para Succeeded.

   

   Além disso, a solicitação de acesso privado ao endpoint é enviada para a fonte de dados. Os administradores da fonte de dados são notificados nas páginas de recursos do portal do Azure para suas fontes de dados. Lá, eles veem uma solicitação de acesso pendente com a mensagem de solicitação.

Tomando o SQL Server como exemplo, os usuários podem navegar até o portal do Azure e procurar o recurso "SQL Server".

1. Na página de Recursos, selecione Rede no menu de navegação e, em seguida, selecione o separador Acesso Privado.

   

2. Os administradores de fontes de dados devem ser capazes de exibir as conexões de ponto de extremidade privadas ativas e novas solicitações de conexão.

   

3. Os administradores podem Aprovar ou Rejeitar fornecendo uma justificativa comercial.

   

4. Depois que a solicitação for aprovada ou rejeitada pelo administrador da fonte de dados, o estado será atualizado na página de configurações do espaço de trabalho do Fabric após recarregar a página.

   

5. Quando o status muda para aprovado, o endpoint pode ser usado em notebooks ou definições de trabalho do Spark para aceder aos dados armazenados na fonte de dados do espaço de trabalho do Fabric.

Usar pontos de extremidade privados gerenciados no Fabric

Os notebooks Microsoft Fabric oferecem suporte à interação contínua com fontes de dados por trás de redes seguras, utilizando pontos de extremidade privados geridos para exploração e processamento de dados. Dentro de um bloco de anotações, os usuários podem ler rapidamente os dados de suas fontes de dados protegidas (e gravar dados de volta) em seus lagos em vários formatos de arquivo.

Este guia fornece exemplos de código para ajudá-lo a começar nos seus próprios blocos de notas para aceder a dados de fontes, como bases de dados SQL, por meio de pontos de extremidade privados geridos.

Pré-requisitos

1. Acesso à fonte de dados. Este exemplo examina o SQL Server do Azure e o Banco de Dados SQL do Azure.

2. Entre no Microsoft Fabric e no portal do Azure.

3. Navegue até a página de recursos do SQL Server do Azure no portal do Azure e selecione o menu Propriedades . Copie o ID do recurso para o SQL Server ao qual o senhor gostaria de se conectar a partir do Microsoft Fabric.

4. Usando as etapas listadas em Criar um ponto de extremidade privado gerido, crie o ponto de extremidade privado gerido a partir da página de configurações de segurança da Rede de Malha.

5. Depois que o administrador da fonte de dados do servidor SQL aprovar a nova solicitação de conexão de ponto de extremidade privado, você poderá usar o Ponto de Extremidade Privado Gerenciado recém-criado.

Conectar-se à fonte de dados a partir de notebooks

1. Inicie sessão no portal Microsoft Fabric.

2. Utilize o alternador de experiência no lado esquerdo da sua página inicial para mudar para a experiência Desenvolver.

3. Navegue até o espaço de trabalho desejado ou crie um novo, se necessário.

4. Para criar um bloco de anotações, selecione Novo item no espaço de trabalho e escolha Bloco de Anotações.

5. Agora, no notebook, especificando o nome do banco de dados SQL e suas propriedades de conexão, pode-se conectar através da conexão de ponto final privado gerido configurada para ler as tabelas no banco de dados e gravá-las no seu armazém de dados no Microsoft Fabric.

6. O código PySpark a seguir mostra como se conectar a um banco de dados SQL.

serverName = "<server_name>.database.windows.net"
database = "<database_name>"
dbPort = 1433
dbUserName = "<username>"
dbPassword = “<db password> or reference based on Keyvault>”

from pyspark.sql import SparkSession

spark = SparkSession.builder \
    .appName("Example") \
    .config("spark.jars.packages", "com.microsoft.azure:azure-sqldb-spark:1.0.2") \
    .config("spark.sql.catalogImplementation", "com.microsoft.azure.synapse.spark") \
    .config("spark.sql.catalog.testDB", "com.microsoft.azure.synapse.spark") \
    .config("spark.sql.catalog.testDB.spark.synapse.linkedServiceName", "AzureSqlDatabase") \ .config("spark.sql.catalog.testDB.spark.synapse.linkedServiceName.connectionString", f"jdbc:sqlserver://{serverName}:{dbPort};database={database};user={dbUserName};password={dbPassword}") \ .getOrCreate()

    
jdbcURL = "jdbc:sqlserver://{0}:{1};database={2}".format(serverName,dbPort,database)
connection = {"user":dbUserName,"password":dbPassword,"driver": "com.microsoft.sqlserver.jdbc.SQLServerDriver"}

df = spark.read.jdbc(url=jdbcURL, table = "dbo.Employee", properties=connection)
df.show()
display(df)

# Write the dataframe as a delta table in your lakehouse
df.write.mode("overwrite").format("delta").saveAsTable("Employee")

# You can also specify a custom path for the table location
# df.write.mode("overwrite").format("delta").option("path", "abfss://yourlakehouse.dfs.core.windows.net/Employee").saveAsTable("Employee")

Agora que a conexão foi estabelecida, a próxima etapa é criar um quadro de dados para ler a tabela no Banco de dados SQL.

Supported data sources (Origens de dados suportadas)

O Microsoft Fabric oferece suporte a mais de 26 fontes de dados às quais se conectar usando pontos de extremidade privados gerenciados. Os usuários precisam especificar o identificador de recurso, que pode ser encontrado na página Configurações de propriedades de sua fonte de dados no portal do Azure. Verifique se o formato de ID do recurso é seguido, conforme mostrado na tabela a seguir.

Por favor, note que a criação de um endereço privado gerido para um serviço de ligação privada no seu locatário do Fabric não é suportada.

Conteúdos relacionados

• Sobre pontos de extremidade privados gerenciados no Fabric
• Sobre links privados no Fabric
• Visão geral das redes virtuais gerenciadas no Fabric