Zmiana bazy danych (chgdb)

Wprowadzenie

Aby zmienić właściwości jednej lub więcej baz danych należy użyć narzędzia chgdb.

Dodatkowo, zalecanym jest zapoznanie się z artykułem Definicje: Zarządzanie system.

Grupa docelowa

  • Administratorzy
  • Konsultanci techniczni

Opis

Narzędzie służy do późniejszej zmiany właściwości jednej lub więcej baz danych. Należy zwrócić uwagę, że specyfikacja identyfikacji systemowych baz danych (repozytorium, OLTP, OLAP) i międzysystemowych baz danych (baza konfiguracyjna) jest inna.

Polecenie

Poniżej znajduje się polecenie wraz ze wszystkimi możliwymi parametrami.

chgdb [-system:<id>][-systemDatabase:<id>*][-configurationDatabase:<id>*]

[-description:<str>]

[-managingSystem:<id>]

[-timeout:<duration>]

[-contentType:<vs>]

[-type:<vs>]

[-olapDatabase:<id>]

[-usage:<vs>]

[-versionNumber:<str>]

[-driver:<vs>]

[-driverAccessPath:<str>]

[-preparedStatements:<int>]

[-user:<str>]

[-plainPassword:<str>]

[-plainPasswordRepetition:<str>]

[-primaryLanguage:<text>]

[-schema:<str>]

[-addSecondaryLanguage:<text-1> …

-addSecondaryLanguage:<text-n>]

[-removeSecondaryLanguage:<text-1> …

-removeSecondaryLanguage:<text-n>]

Parametry

Parametry polecenia zostały wyjaśnione w poniższej tabeli. Parametry w nawiasach kwadratowych są opcjonalne, podczas gdy pozostałe są parametrami obowiązkowymi. Gwiazdka (*) może być określona jako symbol zastępczy dla niektórych parametrów, aby móc wyświetlić wszystkie możliwe wartości. Nie wszystkie parametry mogą być określone więcej niż jeden raz; tylko te z następującym dodatkiem do zmiennych parametrów są dozwolone do wielokrotnego określenia: <str-1> … <str-n>.

Parametr Opis
[-system:<str>] System w przypadku systemowej bazy danych. Domyślnie jest to bieżący system.
[-systemDatabase:<str>*] Nazwa bazy danych w przypadku systemowej bazy danych (OLTP, OLAP, repozytorium).
[-configuration-Database:<str>*] Nazwa bazy danych w przypadku bazy konfiguracyjnej.
[-description:<str>] Nazwa bazy danych.
[-managingSystem:<str>]  Identyfikator bazy danych, który jest zapisywany w nowo utworzonych obiektach w tej bazie danych. Identyfikator bazy danych identyfikuje bazę danych, w której obiekt został utworzony.
[timeout:<duration>] Czas, po którym interaktywne zapytanie do bazy danych zostanie anulowane i uznane za nieudane. Jeśli wyszukiwanie w obszarze nawigacji, w wyszukiwaniu dialogowym lub w aplikacji zapytań trwa dłużej niż ten maksymalny czas trwania zapytania, wyszukiwanie zostanie przerwane, a użytkownikowi zostanie wyświetlony komunikat o błędzie. Zapobiega to wpływowi zbyt złożonych zapytań na czas reakcji systemu. Komunikat, który otrzymuje użytkownik, zawiera informacje o możliwych alternatywnych procedurach. Domyślną wartością jest 45 sekund. Nie można ustawić wartości mniejszej niż 30 sekund.
[-contentType:<vs>] System umożliwia dystrybucję danych systemu do różnych baz danych. Typ zawartości bazy danych określa, które tabele i dane są przechowywane w danej bazie. Możliwe wartości to:

  • Dane konfiguracyjne systemu
  • Dane repozytorium
  • Dane OLTP
  • Dane OLAP

W zależności od ustawionej wartości sprawdzana jest m.in. konwencja nazewnictwa bazy danych. Opis tych konwencji można znaleźć w artykule Konwencja nazewnictwa. Tylko bazy danych z typem zawartości Dane OLTP  mogą mieć odniesienie do bazy danych z typem zawartości Dane OLAP. Bazy danych z typem zawartości Dane OLAP nie mogą mieć żadnych dodatkowych języków.

[-type:<vs>] Sterownik Comarch ERP Enterprise używany dla bazy danych. Sterownik Comarch ERP Enterprise zależy od używanego systemu zarządzania bazą danych i określa między innymi mapowanie typów danych na natywne typy danych DBMS. Możliwe wartości to

  • DB2 UDB dla iSeries
  • Oracle
  • SQL Server
  • PostgreSQL
[-olapDatabase:<str>] Baza danych OLAP używana przez bazę danych OLTP. Tabele i dane do analiz statystycznych bazy danych OLTP są zapisywane w tej bazie danych OLAP. Dla bazy danych OLTP nie trzeba określać bazy OLAP lub można wskazać jedną. Parametru nie można użyć dla baz danych innych niż OLTP. Baza danych OLAP może zostać wprowadzona jako baza danych OLAP dla maksymalnie jednej bazy danych OLTP.
[-usage:<vs>] Przeznaczenie bazy danych:

  • Rozwojowa
  • Korekty
  • Testowa
  • Produkcyjna

Parametr ma charakter informacyjny i nie ma wpływu na działanie systemu.

[-versionNumber:<str>] Krótki tekst informacyjny o bazie danych (maks. 10 linii). Specyfikacja jest opcjonalna i nie ma wpływu na działanie systemu.
[-driver:<vs>] Sterownik JDBC dla bazy danych. Sterownik JDBC musi być zgodny ze sterownikiem bazy danych Comarch ERP Enterprise. Wykorzystywany sterownik określa m.in. protokół wykorzystywany do komunikacji pomiędzy serwerami aplikacji systemu ERP (SAS) a bazą danych. W zależności od warunków licencyjnych producenta, biblioteki Java sterowników dostarczane są wraz z systemem instalacyjnym Comarch ERP Enterprise dla danej platformy bazodanowej lub należy je pozyskać bezpośrednio od producenta. Biblioteki sterowników pobierane są z folderów semiramis/lib oraz semiramis/lib/ext.Do wyboru są następujące wartości:

  • DB2 UDB for iSeries (native)
    Bibliothek: keine
  • DB2 UDB for iSeries (remote)
    Bibliothek: jt400.jar
  • Oracle
    Bibliothek: ojdbc8.jar
  • jTDS SQL-Server
  • PostgreSQL
  • Microsoft SQL-Server
[-driverAccessPath:<str>] Ścieżka dostępu do sterownika JDBC. Składnia ścieżki zależy od używanego sterownika JDBC. Przykłady dla poszczególnych systemów baz danych:

  • DB2 UDB for iSeries native:
    jdbc:db2://servername/collectionname (nie jest już używany)
  • DB2 UDB für iSeries remote:
    jdbc:as400://servername/collectionname
  • jTDS SQL-Server:
    jdbc:jtds:sqlserver://servername:1433 (nie jest już używany)
  • Microsoft SQL-Server:
    jdbc:sqlserver://servername:1433
  • PostgreSQL:
    jdbc:postgresql://servername:port/databasename (Port to domyślny: 5432)
  • Oracle:
    jdbc:oracle:thin:@servername:1521:orcl
[-prepared­Statements:<int>] Liczba przygotowanych instrukcji, które są domyślnie buforowane dla połączenia z tą bazą danych. Jeśli wybrano 0, żadne przygotowane instrukcje nie są ponownie wykorzystywane, co ma negatywny wpływ na wydajność serwera aplikacji uzyskującego dostęp. Im więcej instrukcji jest buforowanych na połączenie z bazą danych, tym częściej przygotowane instrukcje mogą być ponownie wykorzystywane. Prowadzi to do lepszego czasu odpowiedzi serwera aplikacji. Jednak każda przygotowana instrukcja wymaga zasobów zarówno w serwerze aplikacji, jak i systemie zarządzania bazą danych. Domyślna wartość 20 stanowi kompromis między zużyciem zasobów a zwiększoną wydajnością. Określona tutaj wartość może zostać zastąpiona dla połączeń z bazą danych serwera aplikacji.
[-user:<str>] Identyfikator użytkownika systemu DBMS umożliwiający dostęp do bazy danych. Zgodnie z konwencją jest to nazwa bazy danych w większości systemów DBMS. W DB2 UDB jest to umownie użytkownik CISAG.
[-plainPassword:<str>] Hasło dostępu do bazy danych dla użytkownika systemu DBMS.
[-plainPassword-Repetition:<str>] Powtórzenie hasła użytkownika w celu uzyskania dostępu do bazy danych.
[-primaryLanguage:<str>] Główny język bazy danych. Wielojęzyczne atrybuty obiektów biznesowych są przechowywane w języku głównym bezpośrednio w tabeli obiektu biznesowego, ale w językach dodatkowych w oddzielnej tabeli.
[-schema:<str>] Schemat bazy danych. Wartość jest wymagana w zależności od systemu DBMS:

  • Serwer SQL: Nazwa bazy danych
  • DB2 UDB for iSeries: Kolekcja iSeries zawierająca bazę danych.
  • Oracle: Nazwa użytkownika bazy danych
[-addSecondary-Language:<str-1> …-addSecondary-Language:<str-n>] Język, który ma zostać dodany do bazy danych jako język dodatkowy. Podczas zmiany języków bazy danych w większości przypadków należy dostosować zawartość bazy danych. Szczegółowe informacje na ten temat można znaleźć w referencjach polecenia toolshell dla baz danych.
[-removeSecondary-Language:<str-1> …-removeSecondary-Language:<str-n>] Dodatkowy język, którego przypisanie do bazy danych ma zostać usunięte. Podczas zmiany języka bazy danych, zawartość bazy danych musi zostać dostosowana w większości przypadków. Szczegółowe informacje na ten temat można znaleźć w referencjach polecenia toolshell dla baz danych.

Uprawnienia

Następująca jednostka biznesowa jest istotna dla tej aplikacji:
com.cisag.sys.configuration.obj.Database

Czy ten artykuł był pomocny?