Database
Database
Aktiviteler
Bulk Insert
Bu aktivite ile FCMS, NODS, DRDM ve BSCS gibi veri tabanlarına toplu veri ekleme işlemleri yapılabilir. Collection türündeki veriler ya da dosya sisteminden alınan veriler, belirtilen tabloya doğrudan aktarılabilir.
Kullanım Senaryoları:
- Excel veya başka bir kaynaktan alınan verilerin veritabanına toplu olarak eklenmesi
- API ile alınan sonuçların veri tabanında arşivlenmesi
- Büyük veri yüklemelerinin manuel işlem yerine otomatikleştirilmesi
- Zamanlama ve boyutlandırma kontrollü veri aktarım senaryoları
Parametreler:
- Database Type: Bağlantı yapılacak veri tabanı türüdür. Örnek: “NODS”
- Connection String: Hedef veritabanına ait bağlantı bilgilerini içerir. Örnek: “DB String Bağlantı Bilgileri”
- Table: Veritabanına aktarılacak verileri içeren collection türündeki değişkendir. Örnek: “Import Edilecek Collection Türündeki Değişken”
- File Path Choose: Dosya üzerinden veri aktarımı yapılacaksa, dosyanın bulunduğu klasör seçilir.
- File Name: Dosya ile işlem yapılacaksa, dosyanın adıdır. Örnek: “Eklenecek Dosya Adı”
- Delimiter: Dosya içindeki veriler arasındaki ayırıcı karakterdir. Örnek: “,” veya “;”
- Table Name: Verilerin aktarılacağı hedef veritabanı tablosunun adıdır. Örnek: “DB’de Eklenecek Tablo Adı”
- Batch Size: Kaç satırda bir verinin topluca aktarılacağını belirler. Örnek: 1000
- Delay Time: Aktivite çalıştırılmadan önce beklenecek süreyi milisaniye cinsinden belirtir. Örnek: 1000
Dikkat Edilmesi Gerekenler:
- Seçilen veritabanı tipi ile bağlantı bilgileri uyumlu olmalıdır.
- Collection içeriği, hedef tablo yapısıyla aynı alan sırasına ve türüne sahip olmalıdır.
- Dosya ile işlem yapılacaksa dosyanın biçimi (CSV, TXT vs.) delimiter ile uyumlu olmalıdır.
- Yükleme boyutu (Batch Size) çok büyük verilirse performans sorunu yaşanabilir.
Database Check
Bu aktivite, belirtilen veritabanına erişim sağlanıp sağlanamadığını kontrol eder. Oracle, MSSQL ve ODBC gibi farklı veritabanı türlerine bağlantı denemesi yapılmasını sağlar. Başarılı bağlantı durumunda işlem devam eder, bağlantı başarısızsa hata döner.
Kullanım Senaryoları:
- Robot çalıştırılmadan önce veritabanı bağlantı kontrolü yapılmak isteniyorsa
- Otomatik yükleme/okuma işlemlerinden önce bağlantı testi gerçekleştirilmek isteniyorsa
- Farklı sunuculara yapılan bağlantıların sağlıklı çalışıp çalışmadığı kontrol edilmek isteniyorsa
- ODBC tanımlı bağlantılarla işlem yapılacaksa bağlantı test edilmek isteniyorsa
Parametreler:
- Database Type: Bağlantı yapılacak veritabanı türünü belirtir. Örnek: “Oracle”, “Mssql”, “odbc”
- Connection String: Hedef veritabanına ait tüm bağlantı bilgilerini içeren ifadedir. Örnek: “data source=Deneme\ABC;initial catalog=DenemeDatabase;uid=kullaniciAdi;pwd=sifre”
Dikkat Edilmesi Gerekenler:
- Girilen bağlantı bilgilerinin doğru ve güncel olması gerekir. Yanlış host, port veya kullanıcı bilgileri bağlantı hatasına neden olur.
- Eğer Oracle bağlantısı yapılacaksa Data Source, User Id, Password, SID, Host ve Port gibi bilgiler doğru şekilde belirtilmelidir.
- MSSQL bağlantısında data source, initial catalog, uid, pwd alanları doğru girilmeli, Windows Authentication kullanılacaksa trusted_connection=true ifadesi eklenmelidir.
- ODBC bağlantılar için Database Type satırına “odbc” yazılmalı ve Connection String içinde ODBC DSN adı yer almalıdır.
- Güvenlik açısından şifreli girişlerde parolaların hassas şekilde saklanması ve paylaşıma açılmaması önerilir.
Örnekler
- Oracle Connection String: Data Source=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=123.45.67.89)(PORT=1521)))(CONNECT_DATA=(SID=ORCL)));User Id=SUP_GLB01;Password=1234567;
- MSSQL Connection String (Şifreli Giriş): data source=CLMC2\DENEME;persist security info=False;initial catalog=Deneme2;uid=GLBUser;pwd=1234567;MultipleActiveResultSets=True;
- MSSQL Connection String (Windows Authentication): data source=CLMC2\DENEME;initial catalog=Deneme2;Persist Security Info=True;trusted_connection=true;MultipleActiveResultSets=True;
- ODBC Connection String: DSN=MyOdbcDsnName;Uid=kullanici;Pwd=sifre;
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ı
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'”
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’
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
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’)”
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.
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:
- 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ı
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'”
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’
