Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Oracle EF Core integration rewrite #2478

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

alistairmatthews
Copy link
Contributor

@alistairmatthews alistairmatthews commented Jan 22, 2025

Summary

Expands and restructures the article.

Fixes #2306


Internal previews

📄 File 🔗 Preview link
docs/database/oracle-entity-framework-integration.md .NET Aspire Oracle Entity Framework Core integration

@dotnetrepoman dotnetrepoman bot added the database Content related to database. label Jan 22, 2025
Version="*" />
```

---

For more information, see [dotnet add package](/dotnet/core/tools/dotnet-add-package) or [Manage package dependencies in .NET applications](/dotnet/core/tools/dependencies).

## Example usage
### Add Oracle server resource and database resource
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Add Oracle server resource and database resource
### Add Oracle server and database resources

> [!TIP]
> If you'd rather connect to an existing Oracle server, call <xref:Aspire.Hosting.ParameterResourceBuilderExtensions.AddConnectionString*> instead. For more information, see [Reference existing resources](../fundamentals/app-host-overview.md#reference-existing-resources).

### Handling credentials and passing other parameters for the Oracle resource
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Handling credentials and passing other parameters for the Oracle resource
### Add Oracle resource with password parameter


```csharp
var password = builder.AddParameter("password", secret: true);
### Add Oracle database context with enrichment
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there a keyed API, for example Add keyed Oracle client section would be missing if there is.

Comment on lines +275 to +281
| Name | Description |
|-----------------------|----------------------------------------------------------------------------------------------------------------------|
| `ConnectionString` | The connection string of the Oracle database to connect to. |
| `DisableHealthChecks` | A boolean value that indicates whether the database health check is disabled or not. |
| `DisableTracing` | A boolean value that indicates whether the OpenTelemetry tracing is disabled or not. |
| `DisableRetry` | A boolean value that indicates whether command retries should be disabled or not. |
| `CommandTimeout` | The time in seconds to wait for the command to execute. |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| Name | Description |
|-----------------------|----------------------------------------------------------------------------------------------------------------------|
| `ConnectionString` | The connection string of the Oracle database to connect to. |
| `DisableHealthChecks` | A boolean value that indicates whether the database health check is disabled or not. |
| `DisableTracing` | A boolean value that indicates whether the OpenTelemetry tracing is disabled or not. |
| `DisableRetry` | A boolean value that indicates whether command retries should be disabled or not. |
| `CommandTimeout` | The time in seconds to wait for the command to execute. |
| Name | Description |
|-----------------------|--------------------------------------------------------------------------------------|
| `ConnectionString` | The connection string of the Oracle database to connect to. |
| `DisableHealthChecks` | A boolean value that indicates whether the database health check is disabled or not. |
| `DisableTracing` | A boolean value that indicates whether the OpenTelemetry tracing is disabled or not. |
| `DisableRetry` | A boolean value that indicates whether command retries should be disabled or not. |
| `CommandTimeout` | The time in seconds to wait for the command to execute. |


## Get started
[Oracle Database](https://www.oracle.com/database/technologies/) is a widely-used relational database management system owned and developed by Oracle. The .NET Aspire Oracle Entity Framework Core integration enables you to connect to existing Oracle servers or create new servers from .NET with the [`container-registry.orcale.com/databse/free` container image](https://container-registry.oracle.com/ords/f?p=113:4:5999388133692:::RP,4:P4_REPOSITORY,AI_REPOSITORY,P4_REPOSITORY_NAME,AI_REPOSITORY_NAME:1863,1863,Oracle%20Database%20Free,Oracle%20Database%20Free&cs=3L7x5hgm9Co0WJN-3xZTrFJkDyCZKiS8wlK1jg7nU2yE65gVGYh4WbMLzmX59tAHoLwbwWeAz-kjraRQzB1V5TA).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
[Oracle Database](https://www.oracle.com/database/technologies/) is a widely-used relational database management system owned and developed by Oracle. The .NET Aspire Oracle Entity Framework Core integration enables you to connect to existing Oracle servers or create new servers from .NET with the [`container-registry.orcale.com/databse/free` container image](https://container-registry.oracle.com/ords/f?p=113:4:5999388133692:::RP,4:P4_REPOSITORY,AI_REPOSITORY,P4_REPOSITORY_NAME,AI_REPOSITORY_NAME:1863,1863,Oracle%20Database%20Free,Oracle%20Database%20Free&cs=3L7x5hgm9Co0WJN-3xZTrFJkDyCZKiS8wlK1jg7nU2yE65gVGYh4WbMLzmX59tAHoLwbwWeAz-kjraRQzB1V5TA).
[Oracle Database](https://www.oracle.com/database/technologies/) is a widely-used relational database management system owned and developed by Oracle. The .NET Aspire Oracle Entity Framework Core integration enables you to connect to existing Oracle servers or create new servers from .NET with the [container-registry.orcale.com/databse/free](https://container-registry.oracle.com/ords/f?p=113:4:5999388133692:::RP,4:P4_REPOSITORY,AI_REPOSITORY,P4_REPOSITORY_NAME,AI_REPOSITORY_NAME:1863,1863,Oracle%20Database%20Free,Oracle%20Database%20Free&cs=3L7x5hgm9Co0WJN-3xZTrFJkDyCZKiS8wlK1jg7nU2yE65gVGYh4WbMLzmX59tAHoLwbwWeAz-kjraRQzB1V5TA) container image.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
community-contribution database Content related to database.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Rewrite of the Oracle EF Core integration article
2 participants