You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: product_docs/docs/migration_portal/4/04_mp_migrating_database/01_mp_schema_extraction/01_data_pump_utility.mdx
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: "Extracting schemas using Oracle Data Pump utilities"
3
-
3
+
navTitle: Using Oracle Data Pump
4
4
---
5
5
6
6
Migration Portal requires only the metadata in the SQL dump file to assess the extracted schemas.
title: "Extracting schemas using the EDB DDL Extractor"
3
+
navTitle: Using EDB DDL Extractor
4
+
---
5
+
6
+
7
+
Download the latest EDB DDL Extractor script from the Migration Portal Projects page.
8
+
9
+
!!! Note
10
+
Migration Portal might become unresponsive for very large SQL files, depending on your system and browser resource availability. To resolve this, try extracting fewer schemas at a time to reduce the SQL file size.
11
+
12
+
## Prerequisites
13
+
14
+
You can run the EDB DDL Extractor script in SQL Developer or SQL\*Plus. It uses Oracle’s `DBMS_METADATA` built-in package to extract DDLs for different objects under schemas (specified while running the script). The EDB DDL Extractor creates the DDL file uploaded to the portal and analyzed for EDB Postgres Advanced Server compatibility.
15
+
16
+
!!! Note
17
+
You must have `CONNECT` and `SELECT_CATALOG_ROLE` roles and `CREATE TABLE` privilege.
18
+
19
+
### For SQL\*Plus
20
+
21
+
1. Connect to SQL\*Plus and run this command:
22
+
23
+
```sql
24
+
@edb_ddl_extractor.sql
25
+
```
26
+
27
+
1. When prompted, if the Oracle user that is running the script has the required privileges, press **Enter** to continue running the script.
28
+
29
+
1. When prompted, provide the schema name. When extracting multiple schemas, use a comma (`‘,’`) as a delimiter.
30
+
31
+
!!! Note
32
+
If you want to extract all the user schemas from the current database, don't mention any schema names while extracting. However, we recommend mentioning the schema names that you want to extract.
33
+
34
+
1. When prompted, enter the path or directory for the extractor to store the extracted DDL. If you don't specify a path, the extracted DDL is output to the directory where you ran the SQL\*Plus command.
35
+
36
+
1. When prompted, enter `yes`or `no` depending on whether you want to extract dependent objects from other schemas.
37
+
38
+
1. When prompted, enter `yes`or `no` depending on whether you want to extract grant statements from other schemas.
39
+
40
+
## Example
41
+
42
+
1. Run the extractor script:
43
+
44
+
```text
45
+
@edb_ddl_extractor.sql
46
+
```
47
+
48
+
1. Press **Enter**.
49
+
50
+
1. Specify three schemas by separating them with commas:
51
+
52
+
```text
53
+
Enter a comma separated list of schemas to be extracted (Default all schemas): HR, SCOTT, FINANCE
54
+
```
55
+
56
+
1. Enter a path for the output file:
57
+
58
+
On Linux, you might use:
59
+
60
+
```text
61
+
Location for output file (Default current location) : /home/oracle/extracted_ddls/
62
+
```
63
+
64
+
Similarly on Windows:
65
+
66
+
```text
67
+
Location for output file (Default current location) : c:\Users\Example\Desktop\
68
+
```
69
+
70
+
1. Enter `yes` to extract dependent objects in other schemas:
71
+
72
+
```text
73
+
WARNING:
74
+
75
+
Given schema(s) list may contain objects which are dependent on objects
76
+
from other schema(s), not mentioned in the list.` `Assessment may fail
77
+
for such objects. It is suggested to extract all dependent objects
78
+
together.
79
+
Extract dependent object from other schemas?(yes/no) (Default no / Ignored for all schemas option): yes
80
+
```
81
+
82
+
1. Enter `yes` to extract grant statements:
83
+
84
+
```text
85
+
Extract GRANT statements?(yes/no) (Default no): yes
86
+
```
87
+
88
+
### For SQL Developer
89
+
90
+
After loading the `edb_ddl_extractor.sql` script into SQL Developer and connecting to the source Oracle database, run the script. As the script executes, respond to the prompts.
91
+
92
+
1. If the user for the database connection has the required privileges as listed in the **Script Output** tab, select **Yes** to continue running the script.
93
+
94
+
2. Enter a comma-separated list of schemas, and select **OK**.
95
+
96
+
3. Enter the path for the output file, and select **OK**. The default is the location of the DDL Extractor script.
97
+
98
+
4. Enter `yes` or `no` to extract dependent objects, and select **OK**. The default is to not extract dependent objects.
99
+
100
+
5. Enter `yes` or `no` to extract grant statements, and select **OK**. The default setting is not to extract grant statements.
101
+
102
+
Output of the DDL Extractor run appears in the Script Output tab. The name of the output file appears after the `Extraction Completed` message in the script output.
103
+
104
+
!!! Note
105
+
You can also enter single schema name in both SQL\*Plus and SQL Developer.
106
+
107
+
The script then iterates through the object types in the source database. Once the task is completed, the `.SQL` output is stored at the location you entered (e.g., `c:\Users\Example\Desktop\`).
108
+
109
+
See [file encoding](/migration_portal/latest/known_issues_notes/#file-encoding) for information about the file encoding format expected by Migration Portal.
-[Oracle Data Pump utilities](01_data_pump_utility/)
21
-
22
-
For more information, see [Known issues, limitations, and notes](/migration_portal/latest/known_issues_notes/).
23
-
24
-
## Extracting schemas using the EDB DDL Extractor
25
-
26
-
Download the latest EDB DDL Extractor script from the Migration Portal Projects page.
27
-
28
-
!!! Note
29
-
Migration Portal might become unresponsive for very large SQL files, depending on your system and browser resource availability. To resolve this, try extracting fewer schemas at a time to reduce the SQL file size.
30
-
31
-
### Prerequisites
32
-
33
-
You can run the EDB DDL Extractor script in SQL Developer or SQL\*Plus. It uses Oracle’s `DBMS_METADATA` built-in package to extract DDLs for different objects under schemas (specified while running the script). The EDB DDL Extractor creates the DDL file uploaded to the portal and analyzed for EDB Postgres Advanced Server compatibility.
34
-
35
-
!!! Note
36
-
You must have `CONNECT` and `SELECT_CATALOG_ROLE` roles and `CREATE TABLE` privilege.
37
-
38
-
#### For SQL\*Plus
39
-
40
-
1. Connect to SQL\*Plus and run this command:
41
-
42
-
```sql
43
-
@edb_ddl_extractor.sql
44
-
```
45
-
46
-
2. When prompted, if the Oracle user that is running the script has the required privileges, press **Enter** to continue running the script.
47
-
48
-
3. When prompted, provide the schema name. When extracting multiple schemas, use a comma (`‘,’`) as a delimiter.
49
-
50
-
!!! Note
51
-
If you want to extract all the user schemas from the current database, don't mention any schema names while extracting. However, we recommend mentioning the schema names that you want to extract.
52
-
53
-
4. When prompted, enter the path or directory for the extractor to store the extracted DDL. If you don't specify a path, the extracted DDL is output to the directory where you ran the SQL\*Plus command.
54
-
55
-
5. When prompted, enter `yes`or `no` depending on whether you want to extract dependent objects from other schemas.
56
-
57
-
6. When prompted, enter `yes`or `no` depending on whether you want to extract grant statements from other schemas.
58
-
59
-
For example:
60
-
61
-
1. Run the extractor script:
16
+
## Schema extraction methods
62
17
63
-
```text
64
-
@edb_ddl_extractor.sql
65
-
```
18
+
You can perform a schema extraction using the EDB or Oracle extraction tools.Select one of the following for instructions and examples:
66
19
67
-
2. Press **Enter**
68
-
69
-
3. Specify three schemas by separating them with commas:
70
-
71
-
```text
72
-
Enter a comma separated list of schemas to be extracted (Default all schemas): HR, SCOTT, FINANCE
73
-
```
74
-
75
-
4. Enter a path for the output file:
76
-
77
-
On Linux, you might use:
78
-
79
-
```text
80
-
Location for output file (Default current location) : /home/oracle/extracted_ddls/
81
-
```
82
-
83
-
Similarly on Windows:
84
-
85
-
```text
86
-
Location for output file (Default current location) : c:\Users\Example\Desktop\
87
-
```
88
-
89
-
5. Enter `yes` to extract dependent objects in other schemas:
90
-
91
-
```text
92
-
WARNING:
93
-
94
-
Given schema(s) list may contain objects which are dependent on objects
95
-
from other schema(s), not mentioned in the list.` `Assessment may fail
96
-
for such objects. It is suggested to extract all dependent objects
97
-
together.
98
-
Extract dependent object from other schemas?(yes/no) (Default no / Ignored for all schemas option): yes
99
-
```
100
-
101
-
6. Enter `yes` to extract grant statements:
102
-
103
-
```text
104
-
Extract GRANT statements?(yes/no) (Default no): yes
105
-
```
106
-
107
-
#### For SQL Developer
108
-
109
-
After loading the `edb_ddl_extractor.sql` script into SQL Developer and connecting to the source Oracle database, run the script. As the script executes, respond to the prompts.
110
-
111
-
1. If the user for the database connection has the required privileges as listed in the **Script Output** tab, select **Yes** to continue running the script.
112
-
113
-
2. Enter a comma-separated list of schemas, and select **OK**.
114
-
115
-
3. Enter the path for the output file, and select **OK**. The default is the location of the DDL Extractor script.
116
-
117
-
4. Enter `yes` or `no` to extract dependent objects, and select **OK**. The default is to not extract dependent objects.
118
-
119
-
5. Enter `yes` or `no` to extract grant statements, and select **OK**. The default setting is not to extract grant statements.
120
-
121
-
Output of the DDL Extractor run appears in the Script Output tab. The name of the output file appears after the `Extraction Completed` message in the script output.
122
-
123
-
!!! Note
124
-
You can also enter single schema name in both SQL\*Plus and SQL Developer.
-[Oracle Data Pump utilities](01_data_pump_utility/)
125
22
126
-
The script then iterates through the object types in the source database. Once the task is completed, the `.SQL` output is stored at the location you entered (e.g., `c:\Users\Example\Desktop\`).
23
+
EDB recommends using the EDB DDL extractor to extract your schemas.
24
+
Alternatively, you can use Oracle’s Data Pump (IMPDP/EXPDP) tool to export schemas from an Oracle database.
127
25
128
-
See [file encoding](/migration_portal/latest/known_issues_notes/#file-encoding) for information about the file encoding format expected by Migration Portal.
26
+
!!!warning
27
+
If you choose to extract schemas using a different method and then upload the DDL file to Migration Portal, the portal may not be able to assess the file correctly.
28
+
!!!
129
29
30
+
For more information, see [Known issues, limitations, and notes](/migration_portal/latest/known_issues_notes/).
| Upstream merge | Merged with community .NET driver version 8.0.5 and EF Core Driver 8.0.10. See [release notes](https://www.npgsql.org/doc/release-notes/8.0.html) for more information about merge updates. ||
14
+
| Bug fix | Fixed a performance issue. Performance is now improved when reading data while targeting .NET Framework 4.7.2, 4.8, and 4.8.1. |#41979|
15
+
| Enhancement | Added support for EDB Postgres Advanced Server 17.2. ||
16
+
| Enhancement | Added support for `IS TABLE OF`. EDB Postgres Advanced Server supports Oracle nested table collection types created with `CREATE TYPE ... AS TABLE OF` statements. See [Using nested tables](./using_nested_table_types.mdx) for more information. ||
17
+
| Deprecation | Removed .NET5, .NET6, and .NET7 targets as they have reached end of support. ||
EDB .NET Connector is a .NET data provider that allows a client application to connect to a database stored on an EDB Postgres Advanced Server host. The .NET Connector accesses the data directly, allowing the client application optimal performance, a broad spectrum of functionality, and access to EDB Postgres Advanced Server features.
9
+
10
+
The .NET Connector supports the following frameworks:
11
+
12
+
- .NET 8.0
13
+
- .NET Framework 4.7.2, 4.8, and 4.8.1
14
+
- .NET Standard 2.0 and 2.1
15
+
16
+
17
+
## The .NET class hierarchy
18
+
19
+
The .NET class hierarchy contains classes that you can use to create objects that control a connection to the EDB Postgres Advanced Server database and manipulate the data stored on the server. The following are a few of the most commonly used object classes.
20
+
21
+
`EDBDataSource`
22
+
23
+
`EDBDataSource` is the entry point for all the connections made to the database. It's responsible for issuing connections to the server and efficiently managing them. Starting with EDB .NET Connector 7.0.4.1, you no longer need direct instantiation of `EDBConnection`. Instantiate `EDBDataSource` and use the method provided to create commands or execute queries.
24
+
25
+
`EDBConnection`
26
+
27
+
The `EDBConnection` class represents a connection to EDB Postgres Advanced Server. An `EDBConnection` object contains a `ConnectionString` that tells the .NET client how to connect to an EDB Postgres Advanced Server database. Obtain `EDBConnection` from an `EDBDataSource` instance, and use it directly only in specific scenarios, such as transactions.
28
+
29
+
`EDBCommand`
30
+
31
+
An `EDBCommand` object contains a SQL command that the client executes against EDB Postgres Advanced Server. Before you can execute an `EDBCommand` object, you must link it to an `EDBConnection` object.
32
+
33
+
`EDBDataReader`
34
+
35
+
An `EDBDataReader` object provides a way to read an EDB Postgres Advanced Server result set. You can use an `EDBDataReader` object to step through one row at a time, forward only.
36
+
37
+
`EDBDataAdapter`
38
+
39
+
An `EDBDataAdapter` object links a result set to the EDB Postgres Advanced Server database. You can modify values and use the `EDBDataAdapter` class to update the data stored in an EDB Postgres Advanced Server database.
0 commit comments