Konfigurace převodu

Cílem Sada nástrojů pro převod schématu databáze (Oracle do Microsoft SQL) je poskytnout řešení pro migrace schémat databáze. I když je výchozí převod poměrně rozumný, existují případy, kdy uživatelé mohou chtít upravit některá nastavení převodu tak, aby lépe vyhovovala jejich potřebám.

Uživatelské rozhraní konfigurace

Při převodu schématu databáze prostřednictvím uživatelského rozhraní průvodce převodem Sada nástrojů pro převod schématu databáze umožní krok nastavení převodu upravit základní nastavení převodu.

V složitějších scénářích je možné zadat vlastní konfigurační soubor JSON s rozšířenými možnostmi, jak je vysvětleno v další části.

Pokročilá konfigurace převodu

Existuje několik nastavení převodu, která nejsou aktuálně zpřístupněna prostřednictvím uživatelského rozhraní. Tato nastavení je možné upravit prostřednictvím konfiguračního souboru JSON.

Základní struktura konfiguračního souboru vypadá takto:

{
  "options" : <simple-conversion-options>,
  "dataTypeMappings": [
    <data-type-mapping>,
    ...
  ],
  "nameMappings": [
    <object-name-mapping>,
    ...
  ]
}

V následujících částech najdete další podrobnosti o jednotlivých oblastech konfigurace.

Jednoduché možnosti převodu

Oblast options konfigurace má následující schéma:

{
  "msSqlDialect":
    "AzureSqlDatabase"
    | "AzureSqlManagedInstance"
    | "SqlServer2017"
    | "SqlServer2019"
    | "SqlServer2022",
  "quoteIdentifiers": true | false,
  "isMsSqlCaseSensitive": true | false,
}

Následující tabulka popisuje všechny možné možnosti konfigurace v této oblasti:

Mapování datového typu

Oblast dataTypeMappings konfigurace se skládá z více záznamů mapování datových typů. Každý záznam mapování datového typu má následující schéma:

{
  "source": {
    "type": "<oracle-data-type-name>",
    "arguments": [
      <argument-value-matching-expression>,
      ...
    ]
  },
  "target": {
    "type": "<ms-sql-data-type-name>",
    "arguments": [
      <argument-value-expression>,
      ...
    ]
  }
}

Oddíl source definuje zdrojový datový typ, který se mapuje, a skládá se ze dvou částí:

• type je název datového typu Oracle, který se má mapovat;
• arguments je kolekce odpovídajících výrazů, které budou dále filtrovat datový typ na základě hodnot argumentů.

Zdrojová arguments kolekce definuje odpovídající výrazy pro argumenty datového typu na základě jejich pozice. Kolekce by měla obsahovat jeden řetězcový výraz pro každý argument datového typu. Podporované výrazy jsou:

Některé datové typy můžou mít zadané argumenty v názvu typu, například INTERVAL DAY (2) TO SECOND (6). V takových případech by název typu byl INTERVAL DAY TO SECOND, zatímco 2 a 6 jsou považovány za první a druhý argument v uvedeném pořadí.

Část target záznamu mapování datového typu definuje datový typ Microsoft SQL, který se má použít v cílové databázi a který se skládá ze dvou částí:

• type je název datového typu Microsoft SQL, na který se má mapovat;
• arguments je kolekce výrazů, které definují hodnoty pro argumenty cílového datového typu.

Kolekce arguments definuje výrazy hodnot argumentů datového typu na základě pozice argumentů. Kolekce by měla obsahovat jeden řetězcový výraz pro každý argument datového typu. Podporované výrazy jsou:

Následující příklad ukazuje, jak mapovat VARCHAR2 datový typ Oracle, který obsahuje 4000 znaků nebo méně, na NVARCHAR datový typ Microsoft SQL se stejnou délkou jako zdrojový datový typ:

{
  "source": {
    "type": "VARCHAR2",
    "arguments": [
      "*..4000"
    ]
  },
  "target": {
    "type": "NVARCHAR",
    "arguments": [
      "$1"
    ]
  }
}

Mapování názvů objektů

Oblast nameMappings konfigurace se skládá z více záznamů mapování názvů. Každý záznam mapování názvů má následující schéma:

{
  "source": [
    {
      "type":
         "constraint"
         | "index"
         | "materializedview"
         | "sequence"
         | "synonym"
         | "table"
         | "tablecolumn"
         | "tabletrigger"
         | "user"
         | "view",
      "name": "<source-object-name>"
    },
    ...
  ],
  "target": "<target-object-name>"
}

Kolekce source definuje části názvu zdrojového identifikátoru, který se mapuje. Chcete-li například definovat cílový název zdrojového schématu, můžete použít následující zdrojovou kolekci:

[
  { "type" : "user", "name": "MySchema" }
]

Pokud chcete definovat cílový název pro zdrojovou tabulku, měli byste v kolekci zadat název identifikátoru source se dvěma částmi následujícím způsobem:

[
  { "type" : "user", "name": "MySchema" },
  { "type" : "table", "name": "MyTable" }
]

Bude se shodovat s tabulkou s názvem "MySchema"."MyTable"více částí . Většina databázových objektů bude vyžadovat zadání názvů více částí v kolekci source .

Následující tabulka popisuje podporované typy zdrojových objektů:

Vlastnost target je vždy jednoduchý řetězec, který definuje nový název zdrojového objektu, který odpovídá source identifikátoru více částí.

Příklady

Následující příklad ukazuje celý konfigurační soubor, který mapuje VARCHAR2 datový typ Oracle, který obsahuje 4 000 znaků nebo méně, na NVARCHAR datový typ Microsoft SQL se stejnou délkou jako zdrojový datový typ a zároveň nahrazuje HR schéma dbo Oracle v cílové databázi:

{
  "dataTypeMappings": [
    {
      "source": {
        "type": "VARCHAR2",
        "arguments": [
          "*..4000"
        ]
      },
      "target": {
        "type": "NVARCHAR",
        "arguments": [
          "$1"
        ]
      }
    }
  ],
  "nameMappings": [
    {
      "source": [
        { "type": "user", "name": "HR" }
      ],
      "target": "dbo"
    }
  ]
}

Při použití této konfigurace budou všechny převedené objekty ze HR schématu definovány v rámci dbo schématu a všechny odpovídající odkazy na VARCHAR2 datový typ budou nahrazeny znakem NVARCHAR.