<\/div>\n

Merhaba,<\/p>\n

Bu i\u00e7eri\u011fimizde Asp.NET Core Web API mimarisi ile AWS DynamoDB<\/em>‘de basit d\u00fczeyde CRUD i\u015flemlerinin nas\u0131l yap\u0131laca\u011f\u0131na dair bir incelemede bulunuyor olaca\u011f\u0131z. O halde vakit kaybetmeksizin buyrun ba\u015flayal\u0131m…<\/p>\n

AWS DynamoDB Nedir?<\/h4>\n
AWS DynamoDB, Amazon Web Services taraf\u0131ndan sunulan, highly available olan NoSQL tabanl\u0131 bir veritaban\u0131 hizmetidir. AWS’nin Serverless Application Model<\/em>‘i i\u00e7in olduk\u00e7a kullan\u0131\u015fl\u0131 bir yap\u0131ya sahip olan DynamoDB otomatik olarak \u00f6l\u00e7eklendirilebildi\u011fi(auto-scalable) i\u00e7in saniyede milyonlarca iste\u011fi i\u015fleyebilecek ve TB’larca veriyi depolayabilecek bir kapasiteye sahiptir. Ayr\u0131ca veri sorgulama s\u00fcre\u00e7lerinde gecikme pay\u0131 \u015fa\u015f\u0131rt\u0131c\u0131 derecede olduk\u00e7a k\u00fc\u00e7\u00fckt\u00fcr. T\u00fcm bunlar\u0131n yan\u0131nda g\u00fcvenlik i\u00e7in, AWS kaynaklar\u0131na eri\u015fimi g\u00fcvenli bir \u015fekilde kontrol etmemize yard\u0131mc\u0131 olan IAM(Identity and Access Management)<\/em> servisi ile di\u011fer AWS servislerinde oldu\u011fu gibi do\u011fal entegrasyona sahiptir.<\/p>\n
$\"Asp.NET$ <\/a>Amazon, DynamoDB \u00fczerinde ayl\u0131k olarak 25 GB’l\u0131k \u00fccretsiz bir alan sa\u011flamaktad\u0131r. Ayr\u0131ca 200 milyona kadar read\/write i\u015flemlerine de izin vermektedir. Bu, DynamoDB’yi \u00f6\u011frenmek maksatl\u0131 tatbik etmek ve hatta k\u00fc\u00e7\u00fck \u00f6l\u00e7ekli yaz\u0131l\u0131mlarda da istifade edebilmek i\u00e7in olduk\u00e7a yeterli bir imkand\u0131r diye d\u00fc\u015f\u00fcn\u00fcyorum. <\/p>\n
AWS platformuna aws.amazon.com\/tr\/free<\/a> adresinden \u00fccretsiz \u00fcye olabilirsiniz.<\/em><\/p><\/blockquote>\n
DynamoDB Teminolojisi<\/h5>\n
\n
Table<\/em><\/strong>
\nDi\u011fer veritaban\u0131 sistemlerine benzer \u015fekilde DynamoDB’de verilerini table’lar da depolamaktad\u0131r. Bir ba\u015fka deyi\u015fle table’lar veri collection’lar\u0131 olarak kullan\u0131lmaktad\u0131rlar.<\/li>\n
Items<\/em><\/strong>
\nTable’lar da ki her bir veri item olarak nitelendirilmektedir. Di\u011fer ili\u015fkisel veritabanlar\u0131ndaki sat\u0131rlara yahut NoSQL yap\u0131lanmalardaki document’lara kar\u015f\u0131l\u0131k gelmektedir. Item’lar da depolama s\u0131n\u0131r\u0131 s\u00f6z konusu de\u011fildir.\n<\/li>\n
Attributes<\/em><\/strong>
\nHer item, bir veya birden fazla attribute’tan meydana gelmektedir. Attribute’lar temel veri \u00f6\u011feleridir. \u0130li\u015fkisel veritabanlar\u0131ndaki kolonlar\u0131n, normal NoSQL yap\u0131lanmas\u0131ndaki field’lar\u0131n muadilleridir.\n<\/li>\n<\/ul>\n
Ba\u015flarken<\/h4>\n
Art\u0131k DynamoDB’yi incelemek i\u00e7in yava\u015ftan kazmay\u0131 vurabiliriz. Tabi bunun i\u00e7in \u00f6ncelikle makale s\u00fcresince yapaca\u011f\u0131m\u0131z i\u015flemleri ba\u015fta \u00f6nbilgi olmas\u0131 maksad\u0131yla bildirmekte fayda g\u00f6rmekteyim. Bu i\u00e7eri\u011fimizde AWS CLI arac\u0131l\u0131\u011f\u0131yla belirli yap\u0131land\u0131rmalara dayal\u0131 DynamoDB veritaban\u0131 olu\u015fturacak ve bir entity \u00fczerinden temel CRUD operasyonlar\u0131n\u0131 y\u00fcr\u00fcterek, irdelememizi ger\u00e7ekle\u015ftiriyor olaca\u011f\u0131z. <\/p>\n
AWS Console \u0130le DynamoDB’de Tablo Olu\u015fturma<\/h4>\n
Her \u015feyden \u00f6nce DynamoDB’de bir tablo olu\u015fturarak ba\u015flayal\u0131m. Bunun i\u00e7in console \u00fczerinden a\u015fa\u011f\u0131daki g\u00f6rseldeki gibi DynamoDB’yi arat\u0131n\u0131z ve ilgili servise t\u0131klayarak, gidiniz. $\"Asp.NET$ <\/a>Devam\u0131nda ise a\u00e7\u0131lan sayfadan turuncu ‘Create Table’ butonuna t\u0131klayarak tablo olu\u015fturma sayfas\u0131na gidiniz. $\"Asp.NET$ <\/a>Son olarak a\u00e7\u0131lan sayfada olu\u015fturulacak tablo ile ilgili bilgileri giriniz. $\"Asp.NET$ <\/a>Burada dikkat ederseniz tabloya \u00f6rnek maksatl\u0131 ’employees’, primary key kolonuna ise ‘id’ isimlerini vermi\u015f bulunuyoruz. ‘id’ kolonunun, say\u0131sal olup olmayaca\u011f\u0131n\u0131 kendinize g\u00f6re \u00f6zelle\u015ftirebilir ve duruma g\u00f6re belirleyebilirsiniz. \u015eimdilik tabloyu olu\u015fturmak i\u00e7in bu temel ayarlar k\u00e2fidir. <\/p>\n
Ekstradan bir i\u015fleme gerek kalmaks\u0131z\u0131n sayfan\u0131n en alt\u0131na geliniz ve ‘Create Table’ butonuna t\u0131klayarak, tabloyu \u00fcretiniz. $\"Asp.NET$ <\/a><\/p>\n
AWS IAM Arac\u0131l\u0131\u011f\u0131yla Kullan\u0131c\u0131 Olu\u015fturma ve Access Key Generate Etme<\/h4>\n
\u015eimdi DynamoDB’de olu\u015fturulan bu tabloyu ASP.NET Core uygulamalar\u0131nda nas\u0131l kullanabilece\u011fimizi incelemeye ba\u015flayal\u0131m. Tabi ilk olarak AWS DynamoDB’ye eri\u015fim i\u00e7in AWS IAM’de yetkilendirilmi\u015f bir kullan\u0131c\u0131 tan\u0131mlamas\u0131 yap\u0131lmas\u0131 gerekmektedir.<\/p>\n
IAM(Identity and Access Management), AWS kaynaklar\u0131na eri\u015fimi g\u00fcvenli bir \u015fekilde kontrol etmemize yard\u0131mc\u0131 olan bir servistir. A\u00e7\u0131lan oturumlar\u0131, kaynaklar\u0131 kullanmak i\u00e7in yetkilendirilen kullan\u0131c\u0131lar\u0131 vs. denetlememizi sa\u011flamaktad\u0131r.<\/em><\/p><\/blockquote>\n
Bunun i\u00e7in AWS Console \u00fczerinden IAM<\/em> servisine gidiniz ve bir kullan\u0131c\u0131 olu\u015fturunuz. E\u011fer konuya dair pek bilginiz yoksa \u00f6nceden AWS S3<\/a> konusunda klavyeye alm\u0131\u015f oldu\u011fum makaleden konuyla alakal\u0131 b\u00f6l\u00fcm\u00fc okuyarak detayl\u0131 bilgi edinebilirsiniz.<\/p>\n
Burada olu\u015fturulacak kullan\u0131c\u0131 i\u00e7in tek dikkat edilmesi gereken husus policy’sinin ‘DynamoDB’ olacak \u015fekilde ayarlanmas\u0131d\u0131r. $\"Asp.NET$ <\/a> $\"Asp.NET$ <\/a>Kullan\u0131c\u0131y\u0131 olu\u015fturduktan sonra men\u00fc \u00fczerinden tekrar ‘Users’ sayfas\u0131na, oradan da ilgili kullan\u0131c\u0131ya t\u0131klay\u0131n\u0131z ve a\u00e7\u0131lan sayfada ‘Security credentials’ sekmesine gelerek oradan da a\u015fa\u011f\u0131daki ‘Create access key’ butonuna t\u0131klayarak DynamoDB’ye eri\u015fim i\u00e7in gerekli olan access key’i olu\u015fturup, kaydediniz. $\"Asp.NET$ <\/a>Edinilen bu access key ve secret key bilgilerine rahat ve g\u00fcvenilir eri\u015fim sergileyebilmek i\u00e7in AWS CLI ile local bilgisayar\u0131m\u0131za a\u015fa\u011f\u0131daki gibi depolayal\u0131m. $\"Asp.NET$ <\/a>Dikkat ederseniz ‘dynamodb-profile’ ismine kar\u015f\u0131l\u0131k credential bilgilerimiz AWS CLI arac\u0131l\u0131\u011f\u0131yla local’imize kaydedilmi\u015ftir. Ayr\u0131ca se\u00e7ilen region’\u0131n AWS b\u00f6lgenize uygun oldu\u011funa dikkat etmenizde fayda vard\u0131r. Aksi taktirde tabloyu farkl\u0131 bir b\u00f6lgede olu\u015fturduysan\u0131z muhtemel eri\u015fim s\u0131k\u0131nt\u0131s\u0131 ya\u015fayaca\u011f\u0131n\u0131zdan dolay\u0131 sa\u011fl\u0131kl\u0131 bir \u015fekilde kullanamayabilirsiniz.<\/p>\n
Asp.NET Core Uygulamas\u0131yla DynamoDB’yi Kullanma<\/h4>\n
Yukar\u0131da yapt\u0131\u011f\u0131m\u0131z t\u00fcm \u00e7al\u0131\u015fmalar ve altyap\u0131lar neticesinde art\u0131k Asp.NET Core uygulamas\u0131 \u00fczerinden DynamoDB’yi nas\u0131l kullanabilece\u011fimizi teknik olarak incelemeye ge\u00e7ebiliriz. Bunun i\u00e7in bo\u015f bir Asp.NET Core Web API uygulamas\u0131 olu\u015fturunuz ve direkt uygulaman\u0131n ‘appsettings.json’ dosyas\u0131nda biraz \u00f6nce edindi\u011fimiz ve AWS CLI ile local’e kaydetti\u011fimiz access key ve secret key bilgilerini a\u015fa\u011f\u0131daki gibi i\u015fleyiniz.<\/p>\n
\n
\r\n{\r\n "Logging": {\r\n "LogLevel": {\r\n "Default": "Information",\r\n "Microsoft.AspNetCore": "Warning"\r\n }\r\n },\r\n "AllowedHosts": "*",\r\n "AWS": {\r\n "Profile": "dynamodb-profile",\r\n "Region": "ap-south-1"\r\n }\r\n}\r\n<\/pre>\n<\/div>\n
Ard\u0131ndan DynamoDB’ye ba\u011flanabilmek ve gerekli sorgulama s\u00fcrecini ba\u015flatabilmek i\u00e7in Nuget’ten AWSSDK.DynamoDBv2<\/a> ve AWSSDK.Extensions.NETCore.Setup<\/a> k\u00fct\u00fcphanelerini uygulamaya y\u00fckleyiniz. $\"Asp.NET$ <\/a>Bu i\u015flemlerden sonra art\u0131k olu\u015fturdu\u011fumuz ’employees’ tablosunda tutulacak verileri modelleyecek olan bir entity olu\u015fturunuz. Bu entity’nin yap\u0131s\u0131 ve mahiyeti i\u015fin ihtiyac\u0131na ve sizlerin taktirine kalm\u0131\u015ft\u0131r. Ben bu \u00f6rneklendirmede a\u015fa\u011f\u0131daki kadar\u0131yla yetiniyor olaca\u011f\u0131m.<\/p>\n
\n
\r\n [DynamoDBTable("employees")]\r\n public class Employee\r\n {\r\n [DynamoDBHashKey("id")]\r\n public int? Id { get; set; }\r\n\r\n [DynamoDBProperty("name")]\r\n public string? Name { get; set; }\r\n\r\n [DynamoDBProperty("surname")]\r\n public string? Surname { get; set; }\r\n\r\n [DynamoDBProperty("birth_date")]\r\n public DateTime? BirthDate { get; set; }\r\n }\r\n<\/pre>\n<\/div>\n
Yukar\u0131daki kod blo\u011funu incelerseniz e\u011fer ‘Employee’ isminde olu\u015fturdu\u011fumuz bu entity s\u0131n\u0131f\u0131n\u0131 DynamoDB’de ki ’employees’ tablosuyla `DynamoDBTable<\/code> attribute’u arac\u0131l\u0131\u011f\u0131yla e\u015flemekteyiz. Ayr\u0131ca primary key olacak olan ‘Id’ property’sini ise DynamoDBHashKey<\/code> attribute’u ile i\u015faretleyerek belirtmekteyiz.<\/p>\n`
`\u015eimdi ise yap\u0131lan bu konfig\u00fcrasyonlar\u0131 ve DynamoDB context’ini Asp.NET Core pipeline’\u0131na dahil ederek devam edelim.<\/p>\n`
`\n`
\r\n.\r\n.\r\n.\r\nbuilder.Services.AddSwaggerGen();\r\n\r\nbuilder.Services.AddDefaultAWSOptions(builder.Configuration.GetAWSOptions());\r\nbuilder.Services.AddAWSService<IAmazonDynamoDB>();\r\nbuilder.Services.AddScoped<IDynamoDBContext, DynamoDBContext>();\r\n\r\nvar app = builder.Build();\r\n.\r\n.\r\n.\r\n<\/pre>\n<\/div>\n
Dikkat ederseniz 6.<\/strong> sat\u0131rda `AddDefaultAWSOptions<\/code> metodu ile ‘appsettings.json’ dosyas\u0131ndaki yap\u0131land\u0131rmalar\u0131, 7.<\/strong> sat\u0131rda IAmazonDynamoDB<\/code> interface’i ile Amazon DynamoDB servisini ve 8.<\/strong> sat\u0131rda IoC’ye IDynamoDBContext<\/code> aray\u00fcz\u00fcne kar\u015f\u0131l\u0131k DynamoDBContext<\/code> nesnesini ekleyerek servisleri uygulamaya register ediyoruz.<\/p>\n`
`S\u0131rada ise DynamoDB ile CRUD i\u015flemlerini fiilen ger\u00e7ekle\u015ftirebilmek i\u00e7in controller olu\u015fturma vard\u0131r. Bunun i\u00e7in a\u015fa\u011f\u0131daki gibi ‘EmployeesController’\u0131 olu\u015fturunuz.<\/p>\n`
`\n`\r\n [Route("api\/[controller]")]\r\n [ApiController]\r\n public class EmployeesController : ControllerBase\r\n {\r\n readonly IDynamoDBContext _dynamoDBContext;\r\n\r\n public EmployeesController(IDynamoDBContext dynamoDBContext)\r\n {\r\n _dynamoDBContext = dynamoDBContext;\r\n }\r\n\r\n [HttpGet]\r\n public async Task<IActionResult> Get()\r\n {\r\n List<Employee> employees = await _dynamoDBContext.ScanAsync<Employee>(default).GetRemainingAsync();\r\n return Ok(employees);\r\n }\r\n\r\n [HttpGet("{id}")]\r\n public async Task<IActionResult> Get(int id)\r\n {\r\n Employee employee = await _dynamoDBContext.LoadAsync<Employee>(id);\r\n return Ok(employee);\r\n }\r\n\r\n [HttpPost]\r\n public async Task<IActionResult> Post(Employee employeeRequest)\r\n {\r\n Employee employee = await _dynamoDBContext.LoadAsync<Employee>(employeeRequest.Id);\r\n if (employee != null)\r\n return BadRequest($"Employee with Id {employeeRequest.Id} already exists.");\r\n await _dynamoDBContext.SaveAsync(employeeRequest);\r\n\r\n return CreatedAtAction(nameof(EmployeesController.Post), new { employeeRequest.Id }, employeeRequest);\r\n }\r\n\r\n [HttpPut]\r\n public async Task<IActionResult> Put(Employee employeeRequest)\r\n {\r\n Employee employee = await _dynamoDBContext.LoadAsync<Employee>(employeeRequest.Id);\r\n if (employee == null)\r\n return NotFound();\r\n await _dynamoDBContext.SaveAsync(employeeRequest);\r\n\r\n return Ok();\r\n }\r\n\r\n [HttpDelete("{id}")]\r\n public async Task<IActionResult> Delete(int id)\r\n {\r\n Employee employee = await _dynamoDBContext.LoadAsync<Employee>(id);\r\n if (employee == null)\r\n return NotFound();\r\n await _dynamoDBContext.DeleteAsync(employee);\r\n\r\n return NoContent();\r\n }\r\n }\r\n<\/pre>\n<\/div>\nYukar\u0131daki kod blo\u011funu incelerseniz ’employees’ tablosuna veri ekleyecek ve ard\u0131ndan eklenmi\u015f olan bu verileri topluca yahut id bazl\u0131 sorgulayabilecek, g\u00fcncelleyebilecek ve silebilecek t\u00fcm operasyonlar ger\u00e7ekle\u015ftirilmektedir.<\/p>\n \u0130\u015fte bu kadar \ud83d\ude42 Basit d\u00fczeyde uygulaman\u0131n geli\u015ftirilmesi olduk\u00e7a kolay, \u00f6yle de\u011fil mi \ud83d\ude42 \u015eimdi gelin yapt\u0131\u011f\u0131m\u0131z bu \u00e7al\u0131\u015fmay\u0131 test edelim.<\/p>\nTest Edelim<\/h4>\nUygulamay\u0131 aya\u011fa kald\u0131rd\u0131\u011f\u0131m\u0131zda bizleri direkt Swagger kar\u015f\u0131layacakt\u0131r. Ekleme, silme ve g\u00fcncelleme i\u015flemlerini yapt\u0131\u011f\u0131n\u0131z taktirde (umuyorum ki \ud83d\ude42 )kusursuz \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 g\u00f6receksiniz. Burada t\u00fcm aksiyonlar\u0131 test ederek i\u00e7eri\u011fi \u015fi\u015firmektense, numune olmas\u0131 a\u00e7\u0131s\u0131ndan sadece ‘Get’ i\u015flem neticesini incelemek ve DynamoDB’de de ilgili tabloyu fiziksel olarak g\u00f6zlemlemekle yetinmenin kafi olaca\u011f\u0131 kanaatindeyim.<\/a><\/a><\/p>\n Nihai olarak; \nBu i\u00e7eri\u011fimizde, Asp.NET Core uygulamalar\u0131nda DynamoDB ile CRUD i\u015flemlerinin nas\u0131l ger\u00e7ekle\u015ftirilece\u011fini en temel d\u00fczeyde AWS CLI yap\u0131land\u0131rmalar\u0131n\u0131 ve IAM(Identity and Access Management)<\/em> \u00e7al\u0131\u015fmalar\u0131n\u0131 da tekrardan tatbik ederek ele alm\u0131\u015f bulunuyoruz. Okuyarak e\u015flik etti\u011finiz i\u00e7in te\u015fekk\u00fcr ederim…<\/p>\n \u0130lgilenenlerin faydalanmas\u0131 dile\u011fiyle… \nSonraki yaz\u0131lar\u0131mda g\u00f6r\u00fc\u015fmek \u00fczere… \n\u0130yi \u00e7al\u0131\u015fmalar…<\/p>\n Not : \u00d6rnek uygulamay\u0131 a\u015fa\u011f\u0131daki github adresinden edinebilirsiniz. \nhttps:\/\/github.com\/gncyyldz\/AWS.DynamoDB.Example<\/a><\/p>\n","protected":false},"excerpt":{"rendered":" Merhaba, Bu i\u00e7eri\u011fimizde Asp.NET Core Web API mimarisi ile AWS DynamoDB‘de basit d\u00fczeyde CRUD i\u015flemlerinin nas\u0131l yap\u0131laca\u011f\u0131na dair bir incelemede bulunuyor olaca\u011f\u0131z. O halde vakit kaybetmeksizin buyrun ba\u015flayal\u0131m… AWS DynamoDB Nedir? AWS DynamoDB, Amazon...<\/p>\n","protected":false},"author":1,"featured_media":25981,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4446,4730],"tags":[4731,4732,4734,4735,4733,4737,4738,4736],"class_list":["post-25935","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-net-6","category-aws","tag-aws","tag-aws-dynamodb","tag-aws-iam","tag-awssdk-dynamodbv2","tag-dynamodb","tag-dynamodbhashkey","tag-dynamodbproperty","tag-dynamodbtable"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/25935","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/comments?post=25935"}],"version-history":[{"count":31,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/25935\/revisions"}],"predecessor-version":[{"id":25982,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/25935\/revisions\/25982"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media\/25981"}],"wp:attachment":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media?parent=25935"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=25935"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=25935"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}