Visual Studio Code kullanarak Azure Cosmos DB Azure işlevleri Bağlan

Azure Işlevleri, kendi tümleştirme kodunuzu yazmak zorunda kalmadan Azure hizmetlerini ve diğer kaynakları işlevlere bağlamanıza olanak tanır. Hem giriş hem de çıktıyı temsil eden bu bağlamalar, işlev tanımı içinde bildirilmiştir. Bağlamalardan alınan veriler işleve parametre olarak sağlanır. Tetikleyici özel bir giriş bağlama türüdür. Bir işlevde yalnızca bir tetikleyici olsa da, birden çok giriş ve çıkış bağlaması olabilir. Daha fazla bilgi için bkz. Azure işlevleri Tetikleyicileri ve bağlamaları kavramları.

bu makalede, önceki hızlı başlangıç makalesinde oluşturduğunuz işleve Azure Cosmos DB bağlanmak için Visual Studio Code nasıl kullanılacağı gösterilmektedir. bu işleve eklediğiniz çıkış bağlaması, HTTP isteğinden verileri Azure Cosmos DB kapsayıcısında depolanan bir JSON belgesine yazar.

Ortamınızı yapılandırma

Başlamadan önce, Visual Studio Code için Azure veritabanları uzantısını yüklediğinizden emin olun.

Azure Cosmos DB hesabınızı oluşturun

1. Visual Studio Code, etkinlik çubuğunda Azure simgesini seçin.

2. Azure: Databases alanında, önceki makaledeişlev uygulamanızı oluşturduğunuz Azure aboneliğindeki sağ tıklayın (MacOS ' a CTRL + tıklama) ve sunucu oluştur... seçeneğini belirleyin.

   

3. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Seçim
   Bir Azure veritabanı sunucusu seçin	Core (SQL)SQL söz dizimini kullanarak sorgulayabilmeniz için bir belge veritabanı oluşturmayı seçin. Azure Cosmos DB SQL apı 'si hakkında daha fazla bilgi edinin.
   Hesap adı	Azure Cosmos DB hesabınızı tanımlayan benzersiz bir ad girin. Hesap adı yalnızca küçük harf, sayı ve kısa çizgi (-) kullanabilir ve 3 ila 31 karakter uzunluğunda olmalıdır.
   Kapasite modeli seçin	Sunucusuz modda bir hesap oluşturmak Için sunucusuz ' ı seçin.
   Yeni kaynaklar için bir kaynak grubu seçin	Önceki makaledeişlev uygulamanızı oluşturduğunuz kaynak grubunu seçin.
   Yeni kaynaklar için bir konum seçin	Azure Cosmos DB hesabınızın barındırılacağı coğrafi konumu seçin. Verilerinize en hızlı erişimi sağlamak için size veya kullanıcılarınıza en yakın konumu kullanın.

   Yeni hesabınız sağlandıktan sonra bildirim alanında bir ileti görüntülenir.

Azure Cosmos DB veritabanı ve kapsayıcı oluşturma

1. Hesabınıza sağ tıklayıp veritabanı oluştur... seçeneğini belirleyin.

2. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Seçim
   Veritabanı adı	my-database yazın.
   Koleksiyonunuz için girin ve KIMLIĞI	my-container yazın.
   Koleksiyon için bölüm anahtarını girin	/id Bölüm anahtarıolarak yazın.

3. Kapsayıcıyı ve veritabanını oluşturmak için Tamam ' ı seçin.

İşlev uygulaması ayarlarınızı güncelleştirme

Önceki hızlı başlangıç makalesindeAzure 'da bir işlev uygulaması oluşturdunuz. bu makalede, yeni oluşturduğunuz Azure Cosmos DB kapsayıcısına JSON belgelerini yazacak şekilde uygulamanızı güncelleştirdiniz. Azure Cosmos DB hesabınıza bağlanmak için, bağlantı dizesini uygulama ayarlarınıza eklemeniz gerekir. daha sonra yerel. settings. json dosyanıza yeni ayarı indirerek, yerel olarak çalışırken Azure Cosmos DB hesabınıza bağlanabilirsiniz.

1. Visual Studio Code ' de, yeni Azure Cosmos DB hesabınızda (macos üzerinde Ctrl + tıklama) öğesine sağ tıklayın ve bağlantı dizesini kopyala' yı seçin.

   

2. F1 tuşuna basarak komut paletini açın, sonra komutunu arayıp çalıştırın Azure Functions: Add New Setting... .

3. Önceki makalede oluşturduğunuz işlev uygulamasını seçin. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Seçim
   Yeni uygulama ayarı adı girin	CosmosDbConnectionString yazın.
   "CosmosDbConnectionString" için değer girin	yeni kopyaladığınız Azure Cosmos DB hesabınızın bağlantı dizesini yapıştırın.

   Bu, CosmosDbConnectionString Azure 'daki işlev uygulamanızda bağlantı adlı bir uygulama ayarı oluşturur. Şimdi bu ayarı yerel. Settings. JSON dosyanıza indirebilirsiniz.

4. Bir kez F1 tuşuna basarak komut paletini açın, sonra komutunu arayıp çalıştırın Azure Functions: Download Remote Settings... .

5. Önceki makalede oluşturduğunuz işlev uygulamasını seçin. Var olan yerel ayarların üzerine yazmak için Tümüne Evet ' i seçin.

Bu, yeni bağlantı dizesi ayarı da dahil olmak üzere Azure 'daki tüm ayarı yerel projenize indirir. İndirilen ayarların çoğu yerel olarak çalıştırılırken kullanılmaz.

Bağlama uzantılarını kaydetme

Azure Cosmos DB bir çıkış bağlaması kullandığınızdan, projeyi çalıştırmadan önce karşılık gelen bağlama uzantısının yüklü olması gerekir.

dotnet add package Microsoft.Azure.WebJobs.Extensions.CosmosDB 

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.CosmosDB

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[1.*, 2.0.0)"
  } 
}

şimdi projenize Azure Cosmos DB çıktı bağlamayı ekleyebilirsiniz.

Çıktı bağlaması ekleme

Işlevlerde, her bağlama türü direction , type name function. json dosyasında tanımlanması için bir, ve benzersiz gerektirir. Bu öznitelikleri tanımlama yöntemi, işlev uygulamanızın diline bağlıdır.

[CosmosDB(databaseName: "my-database", collectionName: "my-container",
    ConnectionStringSetting = "CosmosDbConnectionString"
    )]IAsyncCollector<dynamic> documentsOut,

public class MultiResponse
{
    [CosmosDBOutput("my-database", "my-container",
        ConnectionStringSetting = "CosmosDbConnectionString", CreateIfNotExists = true)]
    public MyDocument Document { get; set; }
    public HttpResponseData HttpResponse { get; set; }
}
public class MyDocument {
    public string id { get; set; }
    public string message { get; set; }
}

{
    "type": "cosmosDB",
    "direction": "out",
    "name": "outputDocument",
    "databaseName": "my-database",
    "collectionName": "my-container",
    "createIfNotExists": "false",
    "connectionStringSetting": "CosmosDbConnectionString"
}

Çıkış bağlaması kullanan kod ekleme

if (!string.IsNullOrEmpty(name))
{
    // Add a JSON document to the output container.
    await documentsOut.AddAsync(new
    {
        // create a random ID
        id = System.Guid.NewGuid().ToString(),
        name = name
    });
}

[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    [CosmosDB(
        databaseName: "my-database",
        collectionName: "my-container",
        ConnectionStringSetting = "CosmosDbConnectionString")]IAsyncCollector<dynamic> documentsOut,
    ILogger log)
{
    log.LogInformation("C# HTTP trigger function processed a request.");

    string name = req.Query["name"];

    string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    dynamic data = JsonConvert.DeserializeObject(requestBody);
    name = name ?? data?.name;

    if (!string.IsNullOrEmpty(name))
    {
        // Add a JSON document to the output container.
        await documentsOut.AddAsync(new
        {
            // create a random ID
            id = System.Guid.NewGuid().ToString(),
            name = name
        });
    }

    string responseMessage = string.IsNullOrEmpty(name)
        ? "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response."
        : $"Hello, {name}. This HTTP triggered function executed successfully.";

    return new OkObjectResult(responseMessage);
}

[Function("HttpExample")]
public static MultiResponse Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req,
    FunctionContext executionContext)
{
    var logger = executionContext.GetLogger("HttpExample");
    logger.LogInformation("C# HTTP trigger function processed a request.");

    var message = "Welcome to Azure Functions!";

    var response = req.CreateResponse(HttpStatusCode.OK);
    response.Headers.Add("Content-Type", "text/plain; charset=utf-8");
    response.WriteString(message);

    // Return a response to both HTTP trigger and Azure Cosmos DB output binding.
    return new MultiResponse()
    {
         Document = new MyDocument
        {
            id = System.Guid.NewGuid().ToString(),
            message = message
        },
        HttpResponse = response
    };
}

if (name) {
    context.bindings.outputDocument = JSON.stringify({
        // create a random ID
        id: new Date().toISOString() + Math.random().toString().substr(2,8),
        name: name
    });
}

module.exports = async function (context, req) {
    context.log('JavaScript HTTP trigger function processed a request.');

    const name = (req.query.name || (req.body && req.body.name));
    const responseMessage = name
        ? "Hello, " + name + ". This HTTP triggered function executed successfully."
        : "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.";

    if (name) {
        context.bindings.outputDocument = JSON.stringify({
            // create a random ID
            id: new Date().toISOString() + Math.random().toString().substr(2,8),
            name: name
        });
    }

    context.res = {
        // status: 200, /* Defaults to 200 */
        body: responseMessage
    };
}

JSON belgesinin oluşturulmakta olduğunu doğrulama

1. Hizmet Azure portal Azure Cosmos DB hesabınıza geri gidin ve Veri Gezgini.

2. Veritabanınızı ve kapsayıcınızı genişletin ve Öğeler'i seçerek kapsayıcınız içinde oluşturulan belgeleri listelenin.

3. Çıkış bağlaması tarafından yeni bir JSON belgesi oluşturulmakta olduğunu doğrulayın.

   

Güncelleştirilmiş uygulamayı yeniden uygulama ve doğrulama

1. Komut Visual Studio Code F1 tuşuna basarak komut paletini açın. Komut paletinde öğesini arayın ve öğesini Azure Functions: Deploy to function app... seçin.

2. İlk makalede oluşturduğunuz işlev uygulamasını seçin. Projenizi aynı uygulamaya yeniden dağıtıyorsanız, dosyaların üzerine yazma uyarısını silmek için Dağıt'ı seçin.

3. Dağıtım tamamlandıktan sonra işlevi Azure'da tetiklemek için İşlevi Şimdi Yürüt... özelliğini yeniden kullanabilirsiniz.

4. Çıkış bağlamanın yeniden yeni bir JSON belgesi oluşturduğuna emin olmak için Azure Cosmos DB kapsayıcınız içinde oluşturulan belgeleri yeniden kontrol edin.

Kaynakları temizleme

Azure'da kaynaklar işlev uygulamalarına, işlevlere, depolama hesaplarına vb. başvurur. Bunlar kaynak gruplarına ayrılır ve grubu silerek bir gruptaki her şeyi silebilirsiniz.

Bu hızlı başlangıçları tamamlamak için kaynaklar oluşturdunuz. Hesap durumunuza ve hizmet fiyatlandırmanıza bağlı olarak size bu kaynakların ücretleri yansıtılabilir. Kaynaklara artık ihtiyacınız yoksa, şunları yaparak silebilirsiniz:

1. Visual Studio Code ' de, F1 tuşuna basarak komut paletini açın. Komut paletinde, araması yapın ve seçin Azure Functions: Open in portal .

2. İşlev uygulamanızı seçin ve ENTERtuşuna basın. İşlev uygulaması sayfası Azure portal açılır.

3. Genel bakış sekmesinde kaynak grubu' nun yanındaki adlandırılmış bağlantıyı seçin.

   

4. Kaynak grubu sayfasında, dahil edilen kaynakların listesini gözden geçirin ve silmek istediğiniz kaynakların bunlar olduğunu doğrulayın.

5. Kaynak grubunu sil’i seçin ve yönergeleri izleyin.

   Silme işlemi birkaç dakika sürebilir. İşlem tamamlandığında, birkaç saniye boyunca bir bildirim görüntülenir. Bildirimi görüntülemek için sayfanın üst kısmındaki zil simgesini de seçebilirsiniz.

Sonraki adımlar

HTTP ile tetiklenen işlevinizi, JSON belgelerini azure Cosmos DB kapsayıcıya yazacak şekilde Cosmos güncelleştirildi. Artık Visual Studio Code kullanarak İşlev geliştirme hakkında daha fazla Visual Studio Code:

• Azure İşlevleri kullanarak Visual Studio Code

• Azure İşlevleri ve bağlamalarını kullanın.