Desenvolver U-SQL com Python, R e C# para Azure Data Lake Analytics no Visual Studio Code

Artigo
12/20/2023

Saiba como usar Visual Studio Code (VS Code) para escrever código Python, R e C# com U-SQL e enviar trabalhos para o serviço do Azure Data Lake. Para obter mais informações sobre as Ferramentas do Azure Data Lake para VS Code, consulte Usar o código Ferramentas do Azure Data Lake para Visual Studio.

Antes de escrever código personalizado code-behind, você precisa abrir uma pasta ou um workspace no VS Code.

Pré-requisitos para Python e R

Registre assemblies de extensões de Python e R para sua conta do ADL.

Abra sua conta no portal.
- Selecione Visão geral.
- Selecione Script de Exemplo.
Selecione Mais.
Selecione Instalar Extensões U-SQL.
A mensagem de confirmação é exibida após a instalação das extensões de U-SQL.

Observação

Para obter a melhor experiência no serviço de linguagem Python e R, instale a extensão para VSCode de Python e R.

Desenvolver arquivo em Python

Selecione o Novo Arquivo em seu workspace.

Escreva seu código em U-SQL. Veja a seguir um exemplo de código.

REFERENCE ASSEMBLY [ExtPython];
@t  = 
    SELECT * FROM 
    (VALUES
        ("D1","T1","A1","@foo Hello World @bar"),
        ("D2","T2","A2","@baz Hello World @beer")
    ) AS 
        D( date, time, author, tweet );

@m  =
    REDUCE @t ON date
    PRODUCE date string, mentions string
    USING new Extension.Python.Reducer("pythonSample.usql.py", pyVersion : "3.5.1");

OUTPUT @m
    TO "/tweetmentions.csv"
    USING Outputters.Csv();

Clique com o botão direito em um arquivo de script e selecione ADL: Gerar Arquivo de Code Behind em Python.

O arquivo xxx.usql.py é gerado na pasta de trabalho. Escreva seu código no arquivo Python. Veja a seguir um exemplo de código.

def get_mentions(tweet):
    return ';'.join( ( w[1:] for w in tweet.split() if w[0]=='@' ) )

def usqlml_main(df):
    del df['time']
    del df['author']
    df['mentions'] = df.tweet.apply(get_mentions)
    del df['tweet']
    return df

Clique com o botão direito do mouse no arquivo USQL , selecione Compilar Script ou Enviar Trabalho para o trabalho em execução.

Desenvolver arquivo em R

Selecione o Novo Arquivo em seu workspace.

Escreva seu código no arquivo U-SQL. Veja a seguir um exemplo de código.

DEPLOY RESOURCE @"/usqlext/samples/R/my_model_LM_Iris.rda";
DECLARE @IrisData string = @"/usqlext/samples/R/iris.csv";
DECLARE @OutputFilePredictions string = @"/my/R/Output/LMPredictionsIris.txt";
DECLARE @PartitionCount int = 10;

@InputData =
    EXTRACT SepalLength double,
            SepalWidth double,
            PetalLength double,
            PetalWidth double,
            Species string
    FROM @IrisData
    USING Extractors.Csv();

@ExtendedData =
    SELECT Extension.R.RandomNumberGenerator.GetRandomNumber(@PartitionCount) AS Par,
        SepalLength,
        SepalWidth,
        PetalLength,
        PetalWidth
    FROM @InputData;

// Predict Species

@RScriptOutput =
    REDUCE @ExtendedData
    ON Par
    PRODUCE Par,
            fit double,
            lwr double,
            upr double
    READONLY Par
    USING new Extension.R.Reducer(scriptFile : "RClusterRun.usql.R", rReturnType : "dataframe", stringsAsFactors : false);
OUTPUT @RScriptOutput
TO @OutputFilePredictions
USING Outputters.Tsv();

Clique com o botão direito em um arquivo USQL e selecione ADL: Gerar Arquivo de Code Behind em R.
O arquivo xxx.usql.r é gerado na pasta de trabalho. Escreva seu código no arquivo R. Veja a seguir um exemplo de código.
```
load("my_model_LM_Iris.rda")
outputToUSQL=data.frame(predict(lm.fit, inputFromUSQL, interval="confidence"))
```
Clique com o botão direito do mouse no arquivo USQL , selecione Compilar Script ou Enviar Trabalho para o trabalho em execução.

Desenvolver arquivo em C#

Um arquivo code-behind é um arquivo em C# associado a um único script U-SQL. Você pode definir um script dedicado a UDO, UDA, UDT e UDF no arquivo code-behind. UDO, UDA, UDT e UDF podem ser usados diretamente no script sem registrar o assembly primeiro. O arquivo code-behind é colocado na mesma pasta que seu arquivo de script U-SQL de emparelhamento. Se o script for chamado de xxx.usql, o code-behind será chamado de xxx.usql.cs. Se você excluir manualmente o arquivo code-behind, o recurso code-behind será desabilitado para seu script U-SQL associado. Para saber mais sobre como escrever código do cliente para script U-SQL, veja Writing and Using Custom Code in U-SQL – User-Defined Functions (Escrevendo e usado código personalizado em U-SQL — Funções Definidas pelo Usuário).

Selecione o Novo Arquivo em seu workspace.

Escreva seu código no arquivo U-SQL. Veja a seguir um exemplo de código.

@a = 
    EXTRACT 
        Iid int,
    Starts DateTime,
    Region string,
    Query string,
    DwellTime int,
    Results string,
    ClickedUrls string 
    FROM @"/Samples/Data/SearchLog.tsv" 
    USING Extractors.Tsv();

@d =
    SELECT DISTINCT Region 
    FROM @a;

@d1 = 
    PROCESS @d
    PRODUCE 
        Region string,
    Mkt string
    USING new USQLApplication_codebehind.MyProcessor();

OUTPUT @d1 
    TO @"/output/SearchLogtest.txt" 
    USING Outputters.Tsv();

Clique com o botão direito no arquivo USQL e selecione ADL: Gerar Arquivo de Code Behind em CS.

O arquivo xxx.usql.cs é gerado na pasta de trabalho. Escreva seu código no arquivo CS. Veja a seguir um exemplo de código.

namespace USQLApplication_codebehind
{
    [SqlUserDefinedProcessor]

    public class MyProcessor : IProcessor
    {
        public override IRow Process(IRow input, IUpdatableRow output)
        {
            output.Set(0, input.Get<string>(0));
            output.Set(1, input.Get<string>(0));
            return output.AsReadOnly();
        } 
    }
}

Clique com o botão direito do mouse no arquivo USQL , selecione Compilar Script ou Enviar Trabalho para o trabalho em execução.

Desenvolver U-SQL com Python, R e C# para Azure Data Lake Analytics no Visual Studio Code

Pré-requisitos para Python e R

Desenvolver arquivo em Python

Desenvolver arquivo em R

Desenvolver arquivo em C#

Próximas etapas

Recursos adicionais