Studio

Aktiviteler

Bulk Insert

Büyük miktardaki verileri veya dosyaları hedef veri tabanı tablosuna tek seferde ve toplu halde (bulk) hızlı bir şekilde aktarmak için kullanılır. Yüksek hacimli veri yükleme işlemlerinde performansı artırmak ve veri tabanı yazma sürelerini optimize etmek için idealdir.

Kullanım Senaryoları

  • Büyük boyutlu CSV veya metin dosyalarındaki verilerin veri tabanına toplu aktarımı
  • Koleksiyon (Collection) veri yapısındaki çok sayıda kaydın tek seferde tabloya yazılması
  • Günlük veya periyodik veri senkronizasyonu ve aktarım süreçleri

  • Yüksek hacimli veri taşıma işlemlerinde veri tabanı yükünün ve işlem süresinin azaltılması

     

Parametreler:

  • Database Type: Bağlanılacak veri tabanının türünü belirtir. Örnek: "MSSQL", "PostgreSQL" veya "Oracle"
  • Connection String: Veri tabanına erişim sağlamak için gereken bağlantı dizesi bilgisidir. Örnek: "Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;"
  • Table: Toplu aktarılacak verileri içeren koleksiyon değişkenidir. Örnek: ßDataTableCollectionß
  • File Path Choose: Yüklenecek veri dosyasının bulunduğu klasörü arayüz üzerinden seçmeyi sağlar.
  • File Name: Veri aktarımı yapılacak dosyanın adını belirtir. Örnek: "MusteriListesi.csv"
  • Delimiter: Metin veya CSV dosyasındaki sütunları ayırmak için kullanılan ayraç karakteridir. Örnek: ";" veya ","
  • Table Name: Verilerin aktarılacağı hedef veri tabanı tablosunun adıdır. Örnek: "TBL_CUSTOMERS"
  • Batch Size: Veri tabanına tek bir paket halinde tek seferde gönderilecek satır sayısını ifade eder. Örnek: 1000
  • Delay Time: İşlem gerçekleştirilmeden önce uygulanacak bekleme süresini (gecikmeyi) saniye veya milisaniye cinsinden belirler. Örnek: 5

Database Check

Hedef veri tabanına olan bağlantının aktifliğini ve erişilebilirliğini kontrol etmek için kullanılır. Veri tabanı işlemlerine başlamadan önce sunucu bağlantısını doğrulamak ve olası bağlantı hatalarının önüne geçmek için idealdir.

Kullanım Senaryoları

  • Veri tabanı sorguları çalıştırılmadan önce bağlantı durumunun test edilmesi
  • Ağ veya sunucu kesintilerinde sürecin hata almadan kontrollü durdurulması
  • ODBC veritabanı sürücü bağlantılarının doğruluk kontrolü




    Parametreler:
     
  • Database Type: Kontrol edilecek veri tabanının türünü belirtir. Örnek: "MSSQL", "PostgreSQL" veya "Oracle"
  • Connection String: Veri tabanına erişim sağlamak için gereken bağlantı dizesi bilgisidir. Örnek: "Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;"
  • ODBC Dsn Name: ODBC üzerinden bağlantı kurulacaksa tanımlanmış olan Data Source Name (DSN) adını belirtir. Örnek: "MyODBCDataSource"

Delete

Bu aktivite, belirtilen veritabanındaki kayıtları silmek için kullanılır. DELETE sorgusu aracılığıyla, verilen koşula uyan satırlar veri tabanından kalıcı olarak kaldırılır.

Kullanım Senaryoları:

  • Belirli bir durumu karşılayan verilerin silinmesi
  • Test verilerinin veya geçici kayıtların temizlenmesi
  • Robot tarafından eklenen hatalı verilerin geri alınması
  • Senaryo sonunda temizlik işlemlerinin yapılması

Dikkat Edilmesi Gerekenler:

  • DELETE sorguları kalıcı veri kaybına yol açar, koşulsuz kullanımı tehlikelidir.
  • WHERE koşulu belirtilmezse tüm kayıtlar silinir. Bu durumda veri tablosu boşalabilir.
  • Sorgular üretim ortamında çalıştırılmadan önce test edilmelidir.
  • Gerekli durumlarda yedekleme yapılması önerilir.
  • ODBC ile çalışılacaksa Database Type olarak “odbc” girilmeli ve ODBC Dsn Name alanı doldurulmalıdır.

Örnek SQL Komutu:

  • DELETE FROM [dbo].[DenemePersonel] WHERE Ad=’A’



Parametreler:

  • Database Type: Bağlantı yapılacak veritabanı türünü belirtir. Örnek: “mssql”
  • Connection String: Hedef veritabanına ait bağlantı bilgileridir. Örnek: “data source=GBUSQLTOTO1\RPA;initial catalog=DenemeDB;uid=kullanici;pwd=sifre”
  • ODBC Dsn Name: Eğer bağlantı ODBC üzerinden yapılacaksa tanımlı ODBC ismi yazılır. Örnek: “MyOdbcDsn”
  • Delete Query: Silme işlemini gerçekleştirecek SQL sorgusudur. Örnek: “DELETE FROM [dbo].[DenemePersonel] WHERE Ad=’A'”
  • Timeout Seconds parametresi, aktivitenin gerçekleştirdiği işlemin (yanıt alma, veri çekme, bağlantı kurma vb.) tamamlanması için beklenecek maksimum süreyi saniye cinsinden belirler.

Insert

Bu aktivite, veritabanındaki tablolara yeni kayıt eklemek için kullanılır. INSERT INTO komutu yardımıyla, belirtilen sütunlara karşılık gelen değerler veritabanına yazılır.

Kullanım Senaryoları:

  • Otomasyon süreçlerinde dış kaynaktan alınan verilerin veritabanına eklenmesi
  • Form verileri, dosya içerikleri veya kullanıcı giriş bilgilerinin saklanması
  • Loglama işlemleri için kayıt oluşturulması
  • Süreç boyunca oluşan sonuçların veritabanında arşivlenmesi

Dikkat Edilmesi Gerekenler:

  • INSERT komutundaki sütun sayısı ve sırası ile girilen değerlerin uyumlu olması gerekir.
  • Tablodaki zorunlu alanlara (NOT NULL) değer girilmemesi durumunda hata alınabilir.
  • ODBC bağlantısı kullanılacaksa Database Type olarak “odbc” yazılmalı ve ODBC Dsn Name doldurulmalıdır.
  • SQL enjeksiyon riski olan durumlarda değişken veriler doğrudan sorguya gömülmeden önce güvenlik önlemleri alınmalıdır.



Parametreler:

  • Database Type: Bağlantı yapılacak veritabanı türünü belirtir. Örnek: “mssql”
  • Connection String: Hedef veritabanına ait bağlantı bilgileridir. Örnek: “data source=GBUSQLTOTO1\RPA;initial catalog=DenemeDB;uid=kullanici;pwd=sifre”
  • ODBC Dsn Name: Eğer bağlantı ODBC ile yapılacaksa tanımlı ODBC ismi burada yazılır. Örnek: “MyOdbcDsn”
  • Insert Query: Kayıt ekleme işlemini gerçekleştirecek SQL komutudur. Örnek: “INSERT INTO DenemePersonel (Ad,Soyad,No,Lokasyon) VALUES (‘A’,’B’,’1310′,’Ankara’)”
  • Timeout Seconds parametresi, aktivitenin gerçekleştirdiği işlemin (yanıt alma, veri çekme, bağlantı kurma vb.) tamamlanması için beklenecek maksimum süreyi saniye cinsinden belirler.

Run Query

Bu aktivite, veritabanı üzerinde serbest SQL komutları çalıştırmanıza olanak tanır. CREATE, ALTER, DROP, TRUNCATE, MERGE gibi veri tanımlama (DDL) ya da yapılandırma işlemleri için kullanılır.

Kullanım Senaryoları:

  • Yeni bir tablo oluşturmak
  • Var olan tabloyu değiştirmek (sütun eklemek, veri tipi güncellemek vb.)
  • Tablonun veya veritabanı nesnesinin silinmesi
  • Bir defalık özel komutların çalıştırılması (örneğin: prosedür çağırma)
  • Migration işlemleri sırasında DDL komutlarının tetiklenmesi

Parametreler:

  • Timeout Seconds: Sorgunun tamamlanması için izin verilen maksimum zaman aşımı süresini saniye cinsinden belirten parametredir (Örn: 30).
  • Command Type: Çalıştırılacak veritabanı komutunun türünü belirten parametredir (Örn: Text veya StoredProcedure).
  • Parameter Name: Sorguda veya saklı prosedürde kullanılacak parametrenin adını belirten ifadedir (Örn: @CustomerId).
  • Parameter Value: İlgili sorgu parametresine gönderilecek değeri belirten ifadedir (Örn: 10045).
  • Parameter Type: Parametrenin veritabanındaki veri tipini belirten ifadedir (Örn: Int32 veya VarChar).
  • Database Type: Bağlantı yapılacak veritabanı türünü belirtir. Örnek: “mssql”
  • Connection String: Hedef veritabanına ait bağlantı bilgisidir. Örnek: “data source=GBUSQLTOTO1\RPA;initial catalog=DenemeDB;uid=kullanici;pwd=sifre”
  • ODBC Dsn Name: Eğer bağlantı ODBC ile sağlanacaksa tanımlı ODBC ismi burada yazılır. Örnek: “MyOdbcDsn”
  • Query: Çalıştırılacak SQL komutudur. Örnek: “CREATE TABLE DenemePersonel (Ad nvarchar(255), Soyad nvarchar(255), No nvarchar(255), Lokasyon nvarchar(255))”

Dikkat Edilmesi Gerekenler:

  • Yazılan sorgu, veritabanı sunucusu tarafından destekleniyor olmalıdır.
  • Geri alınamaz işlemler için (örneğin DROP TABLE) dikkatli olunmalı ve işlem öncesinde yedek alınmalıdır.
  • Query parametresine birden fazla satırlı komut da girilebilir, ancak noktalı virgül (;) ile ayrılmalıdır.
  • Bağlantı bilgileri ve erişim izinleri sorguyu çalıştırmak için yeterli yetkilere sahip olmalıdır.

Örnek SQL Komutu:

  • CREATE TABLE DenemePersonel (Ad nvarchar(255), Soyad nvarchar(255), No nvarchar(255), Lokasyon nvarchar(255))

Select

Veritabanında tanımlı bir sorguyu çalıştırarak sonuçları collection formatında elde etmek için kullanılır. SELECT komutu ile belirtilen sütunlara ait veriler okunur ve robot sürecinde kullanılabilir hale getirilir.

Kullanım Senaryoları:

  • Süreçte kullanılacak verilerin veritabanından alınması
  • Raporlama, analiz ya da karşılaştırma için dış kaynaklı veri çekilmesi
  • Kullanıcı bilgileri, sipariş listeleri, durum kontrol kayıtları gibi canlı verilerin elde edilmesi
  • Koşullu işlemler için referans veri sağlanması

Parametreler:

  • Database Type: Bağlantı yapılacak veritabanı türüdür. Örnek: “mssql”
  • Connection String: Veritabanı bağlantı bilgisidir. Örnek: “data source=GBUSQLTOTO1\RPA;initial catalog=DenemeDB;uid=kullanici;pwd=sifre”
  • ODBC Dsn Name: ODBC ile bağlantı yapılacaksa kullanılacak DSN adıdır. Örnek: “MyOdbcDsn”
  • Select Query: Çekilecek verilerin SQL sorgusudur. Örnek: “SELECT [Ad],[Soyad],[No],[Lokasyon] FROM [dbo].[DenemePersonel] WITH (NOLOCK)”
  • Delay Time: Aktivite çalıştırılmadan önce beklenecek süredir (milisaniye cinsinden). Örnek: 1000

Dikkat Edilmesi Gerekenler:

  • Sorgunun döndürdüğü veriler collection olarak işlenir, diğer aktivitelerle rahatlıkla kullanılabilir.
  • WITH (NOLOCK) ifadesi performansı artırabilir ancak kirli veri okuma riskine sahiptir.
  • Çok büyük veri setlerinde sorgu süresi uzayabilir, sorguya filtre eklemek faydalıdır.
  • Bağlantı bilgilerinde hata varsa veya erişim izni yoksa işlem başarısız olur.

Örnek SQL Komutu:

  • SELECT [Ad],[Soyad],[No],[Lokasyon] FROM [dbo].[DenemePersonel] WITH (NOLOCK)

Update

Bu aktivite, veritabanında bulunan kayıtların güncellenmesini sağlar. Belirtilen bağlantı üzerinden çalışarak UPDATE sorgularını yürütür ve veri satırlarında değişiklik yapılmasına imkân tanır.

Kullanım Senaryoları:

  • Sistemde kayıtlı bilgilerin güncellenmesi (örneğin; kullanıcı bilgileri, statü güncellemeleri)
  • Otomasyon tarafından işlenen verilerin durumlarının değiştirilmesi
  • Belirli koşulları sağlayan kayıtların eş zamanlı düzenlenmesi
  • Diğer işlemlerle birlikte toplu güncelleme senaryolarının uygulanması

Dikkat Edilmesi Gerekenler:

  • UPDATE komutları doğrudan veri değişikliğine neden olacağından, koşulsuz sorgular tüm tabloyu etkileyebilir.
  • Kullanılan sorgunun doğru tablo ve alanları içerdiğinden emin olunmalıdır.
  • ODBC bağlantısı tercih edilecekse Database Type olarak “odbc” yazılmalı ve ODBC Dsn Name
  • Connection String içeriği kullanılan veritabanı sistemine göre değişiklik gösterebilir (örneğin MSSQL, Oracle).

Örnek SQL Komutu:

  • UPDATE [dbo].[DenemePersonel] SET No = ‘1088’ WHERE Ad = ‘A’



Parametreler:

  • Database Type: Bağlantı yapılacak veritabanı türünü belirtir. Örnek: “mssql”
  • Connection String: Hedef veritabanına ait bağlantı bilgisidir. Örnek: “data source=GBUSQLTOTO1\RPA;initial catalog=DenemeDB;uid=kullanici;pwd=sifre”
  • ODBC Dsn Name: Eğer ODBC kullanılarak bağlantı sağlanacaksa, tanımlı ODBC ismi burada belirtilir. Örnek: “MyOdbcDsn”
  • Update Query: Güncelleme işlemini gerçekleştirecek SQL sorgusudur. Örnek: “UPDATE [dbo].[DenemePersonel] SET No = ‘1088’ WHERE Ad = ‘A'”
  • Timeout Seconds parametresi, aktivitenin gerçekleştirdiği işlemin (yanıt alma, veri çekme, bağlantı kurma vb.) tamamlanması için beklenecek maksimum süreyi saniye cinsinden belirler.